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Irish Times 


“Tim 是 位 特 立 独行 的 商人 ， 他 不 光 放 眼 于 最 长 远 、 最 广阔 的 视野 并 且 切 实地 
按照 Yogi Berra 的 建议 去 做 了 : “如 果 你 在 路 上 遇 到 售 路 口 ， 走 小 路 ( 岔路 )，” 
回顾 过 去 ，Tim 似乎 每 一 次 都 选择 了 小 路 ， 而且 有 几 次 都 是 一 闪 即 逝 的 机 会 ， 
尽管 大 路 也 不 错 。” 


Linux Journal 


帅 识 
译 者 序 


1776 年 ， 美 国 独立 战争 爆发 ， 当 时 北美 还 有 很 多 民众 对 “独立 ”充满 
怀疑 : “北美 真 的 要 脱离 英国 吗 ”"、“ 新 的 国家 需要 怎样 组 织 ”, 这 些 今 
天 看 来 不 是 问题 的 问题 ， 并 没有 清晰 明确 的 答案 。 就 在 此 时 ， 有 位 叫 
托马斯 。 潘 恩 的 人 站 了 出 来 ,单枪匹马 解 开 了 人 们 心中 的 疑惑 ， 大 大 
鼓舞 了 北美 民众 的 独立 情绪 ， 而 他 所 依靠 的 ， 只 是 一 本 名 为 《常识 》 
的 小 册子 。 


《和 常识》 这 本 小 册子 说 了 什么 呢 ? 我 随便 摘录 几 名 。 “如 果 没 有 人 监 
督 ， 对 国王 是 不 能 信任 的 ， 或 者 换 句 话说， 渴望 保 持 专 制 政权 的 欲 
念 是 君主 政体 的 固有 痊 病 。”“ 独 立 自主 的 问题 不 外 平 意味 着 究竟 
是 我 们 将 自己 制定 我 们 的 法 律 ， 还 是 让 这 个 大 陆 的 目前 和 将 来 最 大 
的 敌人 一 一 英 王 来 吟 啊 我 们 ， 除 我 所 喜欢 的 法 律 以 外 不 准 有 任何 法 
律 ”“ 让 我 们 为 宪章 加 网 ， 从 而 使 世人 知道 我 们 是 否 赞成 君主 政体 ， 
知道 北美 的 法 律 就 是 国王 。” ……… 

200 多 年 后 再 读 ， 仍 然 可 以 感受 到 这 些 文字 的 力量 ， 所 以 不 难 想 象 ， 
在 美国 独立 战争 时 ， 告 知 民 众 这 些 道理 ， 能 发 挥 多 么 重要 的 作用 。 据 
载 ， 在 当时 只 有 200 多 万 人 的 北美 ， 成 年 男子 几乎 人 手 一 册 《 常 识 》。 
不 夸张 地 说 ， 这 本 书 推动 了 美国 建国 的 进程 。 


潘恩 既 不 是 高 明 的 政治 哲学 家 ， 也 不 是 熟 详 宣传 的 政客 ， 他 的 书 之 所 


以 具有 如 此 大 的 力量 ， 在 我 看 来 ， 主 要 原因 是 他 能 用 朴素 平实 的 语言 
把 道理 讲 出 来 ， 告 诉 大 家 “原来 是 这 样 的 ”。 换 名 话说 ， 许 多 道理 其 
实 并 不 高 深 ， 但 常识 也 必须 以 “常识 ”的 形式 表达 出 来 ， 大 家 才能 听 
进去 。 


读者 或 许 会 觉得 奇怪 ,一 本 技术 书籍 的 译 者 序 ， 为 什么 要 花 这 么 多 篇 
幅 介绍 历史 呢 ? 之 所 以 这 么 做 ， 是 因为 我 在 翻译 本 书 的 过 程 中 ， 数 次 
想到 托马斯 。 潘 恩 的 《常识 》。 我 深刻 觉得 ， 在 软件 开发 的 各 种 书籍 和 
资料 中 ， 也 应 当 有 类 似 《 常 识 》 的 文本 来 告诉 大 家 : 道理 原来 是 这 样 
的 ， 就 是 这 样 。 


我 相信 ， 任 何 一 位 读者 ， 只 要 认真 看 过 全 书 ， 都 会 发 现 《 简 约 之 美 》 
其 实 只 强调 了 几 条 互相 联系 的 简单 道理 : 软件 是 必然 要 变化 的 ， 变 化 
是 常态 ， 有 变化 就 需要 维护 ， 随 着 时 间 的 推移 ， 维 护 成 本 会 远 远 超 过 
初期 开发 的 成 本 ， 占 据 成 本 的 大 头 ; 因此 ， 在 软件 开发 中 ， 最 重要 的 
是 要 降低 维护 成 本 ， 维 护 成 本 正比 于 系统 的 复杂 程度 ， 所 以 要 降低 维 
护 成 本 ， 系 统 的 设计 就 应 当 追 求 简单 清晰 。 


这 根 逻辑 链条 看 似 简单 ， 其 实 并 非 如 此 。 不 少 有 经 验 的 开发 人 员 ， 似 
平 对 这 类 “道理 ”不 届 一 顾 ， 他 们 更 在 意 新 潮 的 技术 、 先 进 的 架构 、 
流行 的 语言 …… 新 出 了 哪 种 类 库 ， 什 么 软件 新 发 布 了 版 本 ， 大 数据 该 
怎么 处 理 ， 说 起 来 头头 是 道 ， 但 真 刀 真 枪 地 写 起 程序 来 ， 往 往 错漏 百 
出 (其 至 不 自 知 )。 


我 曾经 见 过 一 套 系统 ， 设 计 和 开发 这 套 系统 的 人 几乎 用 到 了 .NET 的 
所 有 高 级 特性 ， 但 95% 以 上 都 用 错 了 ， 结 果 就 是 系统 层次 混乱 、 类 责 
任 混 淆 、 通 讯 完全 不 可 靠 。 诡 异 的 是 ,许多 错误 都 属于 “地 雷 ”， 如 
果 业 务 一 直 维 持 在 原始 甚至 野蛮 的 状态 ， 它 们 几乎 不 会 爆炸 。 不 幸 ， 
业务 无 可 避免 地 要 扩展 、 要 增长 、 要 规范 ， 于 是 地 雷 一 颗 接 一 颗 地 爆 
炸 ， 只 能 投入 大 量 优秀 程序 员 ， 花 比 开发 多 好 儿 倍 的 精力 ， 去 维护 和 
重 构 系统 ， 才 勉强 保证 了 业务 的 发 展 。 最 终 ， 当 系统 重 构 告 一 段落 之 
后 回头 看 ， 甚 实 所 谓 的 “维护 "， 也 无 非 是 “降低 维护 成 本 ”， 一 点 点 
地 去 掉 之 前 那些 花哨 的 特性 ， 用 简单 的 技术 构建 清晰 的 架构 ， 而 已 。 


就 我 所 见 ， 上 面 这 种 情况 并 不 罕见 ， 反 而 非常 常见 ， 更 糟糕 的 是 ， 还 
有 许多 项 目 始终 不 得 解脱 ， 被 高 昂 的 维护 成 本 死 死 困 住 ， 即 便 推倒 重 
来 ， 因 为 设计 和 开发 仍然 缺乏 对 “降低 维护 成 本 ”的 足够 重视 ， 导 致 
悲剧 重 现 …… 


说 起 来 ， 这 一 切 的 根源 都 是 因为 目标 不 明确 ， 没 有 考虑 且 不 重视 维护 
成 本 ,也 没有 考虑 设计 的 简洁 清晰 。 其 中 的 道理 不 算 复 杂 ， 但 怎么 才 
能 让 大 家 明白 ?这 个 问题 我 一 直 在 思考 ， 所 以 在 翻译 本 书 时 ， 才 会 反 
复 想 起 托马斯 。 潘 恩 的 《常识 》 一 一 软件 开发 需要 常识 ， 软 件 开发 的 
资料 里 需要 《常识 》 之 类 的 读本 ， 不 需要 艰深 的 道理 ， 也 不 需要 花哨 
的 说 辞 。 潘 恩 的 《和 常识》 用 短小 的 篇 幅 向 广大 民众 证 清 了 “北美 应 该 
独立 ， 且 不 需要 国王 ”， 我 希望 《简约 之 美 》 也 能 用 短小 的 篇 幅 向 广 
大 开发 人 员 说 明 “ 应 当 重 视 软 件 的 维护 成 本 ,追求 简单 清晰 的 设计 ”。 
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好 程序 员 和 差 程序 员 的 


到 
ll 


做 的 事情 ， 优 秀 的 程序 员 则 相反 。 信 不 信 由 你 ， 道 理 就 是 这 么 


写 这 本 书 ， 是 为 了 帮助 各 位 程序 员 ， 以 适用 于 各 种 编程 语言 、 各 种 项 
目的 广阔 视角 来 理解 软件 开发 。 本 书 以 普通 人 容易 理解 的 方式 ， 讲 解 


了 软件 开发 的 科学 规律 。 


区 别 在 于 理解 能 力 。 差 劲 的 程序 员 不 理解 自己 


简单 。 


如 果 你 是 程序 员 ， 这 些 规律 能 够 说 明 ， 为 什么 有 些 开发 方法 有 效 ， 另 
一 些 无 效 。 这 些 规则 也 会 指引 你 在 日 常 工作 中 做 出 开发 决策 ， 帮 助 你 
的 团队 进行 高 质量 的 交流 ， 最 终 制订 出 合理 的 计划 。 


如 果 你 不 是 程序 员 ， 但 身 在 软件 行业 ， 仍 然 可 以 享受 到 本 


至 


BB 的 价值 : 


它 既 是 提供 给 初级 程序 员 的 优秀 教材 ， 又 包含 对 高 级 程序 员 相 当 有 


用 的 知识 ， 


它 帮助 你 更 深入 地 理解 软件 工程 师 某 些 行为 的 原因 ， 以 及 软件 为 何 


要 以 某 种 方式 来 开发 ， 


它 帮助 你 理解 优秀 的 软件 工程 师 做 决定 的 基本 原理 ， 让 你 与 开发 人 


员 更 顺畅 地 沟通 。 
想 的 状态 是 ， 软 件 行业 中 的 每 个 人 都 可 以 阅读 并 理解 这 本 和 


卢 ， 即 便 


他 们 没有 多 少 编程 经 验 ， 其 至 母语 不 是 英语 也 无 所 谓 。 如 果 你 已 经 有 
相当 的 技术 积累 ， 把 握 书 中 的 概念 会 更 加 容易 ， 但 是 大 部 分 内 容 不 需 


要 编程 经 验 就 能 理解 。 


实际 上 ， 本 书 虽 然 讲 的 是 软件 开发 ， 却 没有 多 少 代 码 。 这 怎么 可 能 呢 ? 
答案 是 ， 其 中 的 思想 适用 于 各 种 软件 项 目 、 各 种 语言 。 要 明白 如 何 运用 
这 些 思想 ， 并 不 需要 懂得 某 一 门 具体 的 编程 语言 。 相 反 ， 本 书 中 包含 了 
大 量 的 实例 和 比喻 ， 它 们 会 让 你 更 好 地 理解 所 表述 的 每 条 原理 。 
最 重要 的 是 ， 这 本 书 是 为 了 帮助 你 而 写 的， 希望 能 助 你 在 软件 开发 中 
保持 头脑 清醒 、 遵 守 秩 序 、 写 出 简洁 代码 。 我 希望 它 读 起 来 是 一 种 享 
受 ， 它 有 助 于 改善 你 的 生活 ， 你 的 软件 。 


排版 约定 

本 书 中 格式 约定 如 下 。 

黑体 : 表示 新 术语 。 

等 宽 字 体 ; 用 于 代码 示例 ， 在 段落 中 使 用 时 ， 表 示 与 程序 有 关 的 部 
分 ， 比 如 变量 或 者 函数 名 。 

SR 此 图 标 表示 提示 、 建 议 或 者 普通 的 旁 注 。 
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这 些 年 来 ， 我 的 blog 上 收 到 的 评论 和 反馈 ， 帮 我 确定 了 本 书 的 形式 和 
内 容 。 在 这 里 要 感谢 参与 其 中 的 所 有 人 ， 即 使 你 们 仅仅 给 我 鼓励 ， 或 
者 是 告诉 我 你 读 过 我 的 文章 。 


从 个 人 来 说 ， 我 尤其 要 感谢 Jevon Milan、Cathy Weaver， 以 及 与 他 们 
工作 过 的 所 有 人 。 确 切 地 说 ， 有 了 他 们 ， 我 才能 写 出 这 本 书 。 最 后 ， 
要 向 我 的 朋友 Ron 致敬 ， 没 有 他 ， 这 本 书 根本 不 可 能 出 现 。 


使 用 示例 代码 


让 我 们 助 你 一 璧 之 力 。 也 许 你 要 在 自己 的 程序 或 文档 中 用 到 本 书 中 的 
代码 。 除 非 大 段 大 段 地 使 用 ， 否 则 不 几 与 我 们 联系 取得 授权 。 例 如 ， 
无 需 请 求 许可 ， 就 可 以 用 本 书 中 的 几 段 代码 写成 一 个 程序 。 但 是 销售 
或 者 发 布 O'Reilly 图 书 中 代码 的 光盘 则 必须 事先 获得 授权 。 引 用 书 中 
的 代码 来 回答 问题 也 无 需 授权 。 将 大 段 的 示例 代码 整合 到 你 自己 的 产 
品 文档 中 则 必须 经 过 许可 。 


我 们 非常 希望 你 能 标明 出 处 ,但 并 不 强求 。 出 处 一 般 含 有 书 名 、 作 
者 、 出 版 商 和 ISBN， 例 如 “Code Simplicity: The Science of Software 
Development by Max Kanat-Alexander (O'Reilly，2012) 版 权 所 有 ， 
978-1-4493-1389-0”。 


如 果 有 关于 使 用 代码 的 未 尽 事宜 ， 可 以 随时 与 我 们 取得 联系 ， 


permissions @oreilly.com.。 


Safari 在 线 图 书 
Sa fa ri Safari 在 线 图 书 是 应 需 而 变 的 数字 图 书馆 。 


它 能 够 让 你 非常 轻松 地 搜索 7500 多 种 技 
Books Online 术 性 和 创新 性 参考 书 以 及 视频 ， 以 便 快 速 
地 找到 需要 的 答案 。 


订阅 后 就 可 以 访问 在 线 图 书馆 内 的 所 有 页 面 和 视频 。 可 以 在 手机 或 其 
他 移动 设备 上 阅读 ， 还 能 在 新 书 上 市 之 前 抢先 阅读 ， 也 能 够 看 到 还 在 


二 | 


本 3 


ll 


创作 中 的 书稿 并 向 作者 反馈 意见 。 复 制 粘 贴 代 码 示例 、 放 入 收藏 夹 、 
下 载 部 分 章节 、 标 记 关 键 点 、 做 笔记 甚至 打印 页 面 等 有 用 的 功能 可 以 
节省 大 量 时 间 。 
这 本 书 〈 英 文 版 ) 也 在 其 中 。 和 欲 访问 本 书 英文 版 的 电子 版 ， 或 者 由 
O’Reilly 或 其 他 出 版 社 出 版 的 相关 图 书 , 请 到 http://my.safaribooksonline. 
com 免费 注册 。 


外 ， 入 3 + 
我 们 的 联系 方式 
请 把 对 本 书 的 评论 和 问题 发 给 出 版 社 。 
美国 : 
O’Reilly Media, Inc. 
1005 Gravenstein Highway North 
Sebastopol, CA 95472 


中 国 : 
北京 市 西城 区 西直门 南大 街 2 号 成 铭 大 厦 C 座 807 室 (100035) 
奥 菜 利 技术 咨询 (北京) 有 限 公 司 


O’Reilly 的 每 一 本 书 都 有 专属 网 页 ， 你 可 以 在 那儿 找到 关于 本 书 的 相 
关 信 息 ， 包 括 勘 误 表 、 示 例 代码 以 及 其 他 信息 。 本 书 的 网 站 地 址 是 : 
http://www.oreilly.com/catalog/9781449313890 


中 文书 : 
http://www.oreilly.com.cn/index.php?func=book&isbn=9787115302380 


对 于 本 书 的 评论 和 技术 性 的 问题 ， 请 发 送 电 子 邮 件 到 : 


bookquestions @oreilly.com 


关于 本 书 的 更 多 信息 、 会 议 、 资 源 中心 和 网 络 ， 请 访问 以 下 网 站 : 


http://www.oreilly.com 


http://www.oreilly.com.cn 
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计算 机 带 来 了 社会 的 剧变 。 因 为 有 了 它 ， 我 们 可 以 用 更 少 的 人 ， 干 更 
多 的 事情 。 这 就 是 计算 机 的 价值 一 一 它 可 以 干 很 多 的 事情 ， 而 且 速 度 
相当 快 。 


这 挺 棒 的 。 


但 是 ， 计 算 机 会 出 问题 ， 而 且 总 出 问题 。 如 果 你 家 里 其 他 东西 出 问题 
有 计算 机 那么 频繁 ,你 多 半 会 退货 。 生 活 在 现代 的 大 多 数 人 ， 每 天 至 
少 会 遇 到 一 次 系统 崩溃 或 者 程序 错误 。 


这 就 没 那 么 棒 了 。 


1.1 计算 机 出 了 什么 问题 ? 


为 什么 计算 机 这 么 容易 出 问题 ? 如果 是 软件 的 问题 ， 那 么 有 而 且 只 有 
一 个 原因 : 程序 写 得 太 粳 糕 。 有 些 人 怪罪 管理 ， 有 些 人 怪罪 客户 ， 但 
是 调查 发 现 ， 问 题 的 根源 通常 都 在 于 编程 。 


那么 ,“ 程 序 写 得 太 粳 糕 ” 是 什么 意思 ? 这 是 个 很 模糊 的 说 法 。 通 常 
来 说 ， 程 序 员 都 是 很 聪明 、 很 理智 的 人 ， 他 们 怎么 会 编 出 “糟糕 ”的 
程序 呢 ? 


说 穿 了 ， 这 一 切 都 与 复杂 性 有 关 。 

今天 ， 计 算 机 大 概 是 我 们 能 生产 的 最 复杂 的 设备 了 。 它 每 秒 钟 可 以 计 
算数 十 亿 次 ， 它 内 部 数 以 亿 计 的 电子 元 件 必 须 精 密 协调 ， 整 台 计 算 机 
才 可 以 正常 运行 。 

计算 机 上 跑 着 的 程序 同样 复杂 。 举 例 来 说 ， 微 软 的 Windows 2000 还 
在 开发 时 ， 就 可 算 有 史 以 来 规模 最 大 的 软件 了 ， 它 包含 3000 万 行 代 
码 ， 这 大 概 相 当 于 2 亿 字 一 一 是 《不 列 颠 百科 全 书 》 字 数 的 5 倍 。 
程序 的 复杂 性 问题 可 能 更 加 麻烦 ， 因 为 程序 里 没有 摸 得 着 的 东西 。 程 
序 出 问题 的 时 候 ， 你 也 找 不 到 什么 实 实在 在 的 东西 ， 打 开 瞧 瞧 里 面 发 
生 了 什么 。 程 序 完 全 是 抽象 的 ， 非 常 难 处 理 。 其 实 ， 常 见 的 计算 机 程 
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序 就 已 经 足够 复杂 ， 没 有 人 可 以 从 头 到 尾 理解 所 有 代码 是 如 何 工 作 
的 。 程 序 越 大 ， 越 是 如 此 。 


这 样 说 来 ， 编 程 就 成 了 把 复杂 问题 化 解 为 简单 问题 的 劳动 。 否 则 ， 一 
且 程 序 达到 某 种 复杂 程度 ， 就 没有 人 可 以 理解 了 。 程 序 中 复杂 的 部 分 
必须 以 某 种 简单 方式 组 织 起 来 ， 这 样 ， 不 需要 神 那样 强大 的 思维 ， 普 
通 程序 员 也 可 以 开发 出 来 。 


这 就 是 编程 所 要 用 到 的 艺术 和 才能 一 一 化 繁 为 简 。 


“ 差 程 序 员 ”是 不 会 化 繁 未 简 的 。 他 们 总 以 为 用 编程 语言 (这 东西 本 
来 就 够 复杂 了 ) 写 出 “能 跑 通 ”的 程序 ， 就 已 经 化 解 了 复杂 性 ， 而 没 
有 考虑 降低 其 他 程序 员 需 要 面 对 的 复杂 性 。 


大 概 就 是 这 么 一 回 事 。 


设想 一 下 ， 为 了 把 钉子 钉 到 地 板 上 ， 工 程 师 发 明了 一 台 机 器 ， 上 面 有 
皮带 轮 ， 有 绳子 ， 还 有 磁铁 。 你 多 半 会 觉得 这 很 充 唐 。 


再 设想 ， 有 人 告诉 你 说 :“ 我 需要 一 段 代 码 ， 它 能 用 在 任何 程序 的 任 
何 地 方 ， 能 够 通过 任何 介质 ， 实 现 两 台 计算 机 之 间 的 通信 。” 这 个 问 
题 无 疑 很 难 化 党 为 简 。 所 以 ， 有 些 程序 员 (大 多 数 程序 员 ) 在 这 种 情 
况 下 给 出 的 解法 ， 就 像 是 一 台 装 备 了 皮带 轮 、 绳 子 、 磁 铁 的 机 器 ， 其 
他 人 当然 很 难看 得 懂 。 并 不 是 这 些 程序 员 缺 少 理性 ， 他 们 的 脑子 也 没 
有 进 水 。 他 们 面 对 的 问题 确实 困难 ， 设 定 的 期 限 也 很 紧 ， 他 们 能 做 的 
就 是 这 些 。 在 这 些 程序 员 看 来 ， 写 出 来 的 东西 是 能 用 的 ， 它 符合 要 
求 。 这 就 是 他 们 的 老板 需要 的 ， 看 来 也 应 该 是 客户 需要 的 。 


不 过 ， 这 些 程序 员 毕 竞 没 做 到 化 汉 为 简 。 完 工 之 后 ， 他 们 把 结果 交 给 
其 他 程序 员 ， 其 他 程序 员 又 会 在 这 之 上 继续 增添 复杂 性 ， 完 成 自己 的 
工作 。 程 序 员 对 化 解 复 杂 性 考虑 得 越 少 ， 程 序 就 越 难 懂 。 

于 是 程序 变 得 无 比 复 杂 ， 最 终 没 办 法 找 出 其 中 的 各 种 问题 。 喷 气 式 飞 
机 差不多 也 有 这 么 复杂 ， 但 它们 的 造价 是 几 百 万 其 至 儿 十 亿美 元 ， 而 
且 仔 细 排 查 过 错误 。 大 多 数 软件 的 售 价 只 有 50 ~ 100 美元 。 价 钱 这 


4 | 第 1 章 


么 低 ， 没 有 人 有 足够 的 时 间 和 资源 ， 在 几乎 无 限 复杂 的 系统 里 找到 所 
有 的 问题 。 


所 以 ,“ 好 程序 员 ” 应 当 竭尽 全 力 ， 把 程序 写 得 让 其 他 程序 员 容 易 理 
解 。 因 为 他 写 的 东西 都 很 好 懂 ， 所 以 要 找 出 bug 是 相当 容易 的 。 


这 个 关于 简单 性 的 想法 有 时 被 误解 为 ， 程 序 不 应 当 包含 太 多 代码 ， 或 
者 是 不 应 当 使 用 先进 技术 。 这 人 么 想 是 不 对 的 。 有 时 候 ， 大 量 的 代码 也 
可 以 带 来 简单 ， 只 不 过 增加 了 阅读 和 编写 的 工作 量 而 已 ， 这 是 完全 正 
常 的 。 你 只 要 保证 ， 那 些 大 段 的 代码 提供 了 化 解 复杂 性 所 必须 的 简短 
注释， 就 足够 了 。 同 样 ， 通 常 来 说 ， 更 先进 的 技术 只 会 让 事情 更 简 
单 ， 只 是 一 开始 你 得 学 习 ， 所 以 整个 过 程 可 能 没 那么 简单 。 


有 些 人 相信 ， 把 程序 写 得 简单 所 花 的 时 间 ， 要 比 写 “能 用 就 好 ”的 程 
序 更 多 。 其 实 ， 花 更 多 的 时 间 把 程序 写 简单 ， 相 比 一 开始 随意 拼凑 些 
代码 再 花 大 量 的 时 间 去 理解 ， 要 快 得 多 。 这 个 问题 说 起 来 轻巧 ， 显 得 
轻描淡写 ， 其 实 软件 开发 的 历史 教训 很 多 ， 诸 多 事例 已 经 反复 证 明了 
这 一 点 。 许 多 大 型 程序 的 开发 之 所 以 会 停 请 数 年 ， 就 是 因为 一 开始 没 
有 做 好 ， 结 果 必 须 等 上 这 么 长 的 时 间 ， 才 能 给 之 前 开发 出 来 的 怪物 加 
上 新 功能 。 


正 因为 如 此 ， 计 算 机 经 常 出 问题 一 一 因为 大 多 数 程序 都 有 这 个 问题 ， 
许多 程序 员 在 写 程序 时 并 没有 化 解 复 杂 性 。 是 的 ， 这 么 做 很 难 。 但 是 
如 果 程 序 员 做 不 到 这 一 点 ， 设 计 出 的 系统 过 于 复杂 、 经 常 出 问题 ， 用 
户 在 使 用 的 过 程 中 就 会 经 受 无 穷 无 尽 的 折磨 。 这 么 一 比 ， 把 程序 写 简 
单 所 费 的 工夫 实在 算 不 了 什么 。 


1.2 程序 究竟 是 什么 ? 
大 多 数 人 说 的 “计算 机 程序 "， 其 实 有 完全 不 同 的 定义 ， 


(1) 给 计算 机 的 一 系列 指令 
(2) 计算 机 依据 指令 进行 的 操作 
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第 一 种 定义 是 程序 员 写 程序 时 所 用 的 。 第 二 种 定义 是 使 用 程序 的 普通 
用 户 所 用 的 。 程 序 员 命令 计算 机 : 在 屏幕 上 显示 一 头 猪 。 这 就 是 第 一 
种 定义 ， 它 包含 若干 指令 。 计 算 机 接收 到 指令 之 后 ， 会 控制 电信 号， 
在 屏幕 上 显示 一 头 猪 。 这 是 后 一 种 定义 ， 即 计算 机 执行 的 操作 。 程 序 
员 和 用 户 都 会 说 自己 在 和 “计算 机 程序 ”打交道 ， 但 是 他 们 的 用 法 
是 很 不 一 样 的。 程序 员 面 对 的 是 字母 和 符号 ， 用 户 看 到 的 是 最 终结 
果 一 一 计算 机 执行 的 操作 。 


所 以 ， 计 算 机 程序 其 实 是 这 两 者 的 混合 体 : 程序 员 的 指令 、 计 算 机 执 
行 的 操作 。 编 写 指令 的 最 终结 果 就 是 让 计算 机 执行 那些 操作 一 一 如 果 
不 需要 执行 操作 ， 就 没 必要 去 写 代码 了 。 这 就 好 像 在 生活 里 ， 你 列 了 
一 张 购物 单 (相当 于 指令 )， 告 诉 自己 该 买 哪些 东西 。 如 果 你 只 是 列 了 
单子 ,但 没 去 商店 ， 单 子 就 没有 任何 意义 。 指 令 必 须 得 到 实际 的 结果 。 


但 是 ， 列 购物 单 和 写 程序 有 显著 的 区 别 。 如 果 购 物 单 列 得 很 乱 ， 只 不 
过 会 降低 买 东 西 的 速度 。 但 是 如 果 程 序 写 得 很 乱 ， 实 现 最 终 的 目标 就 
显得 尤其 困难 。 为 什么 呢 ? 因为 购物 单 是 简单 短小 的 ， 用 完 就 可 以 殷 
掉 。 而 程序 是 很 复杂 很 庞大 的 ， 你 可 能 还 需要 维护 很 多 年 。 所 以 ， 同 
样 是 没有 秩序 ， 购 物 单 只 会 给 你 造成 一 点 儿 小 麻烦 ， 程 序 却 可 以 给 你 
增添 无 尽 的 烦恼 。 


而 且 ， 除 软件 开发 之 外 ， 没 有 任何 领域 的 指令 和 结果 联系 得 这 么 紧 
密 。 在 其 他 领域 ， 人 们 先 编写 指令 ， 然 后 交 给 其 他 人 ， 指 令 通常 要 等 


很 长 的 时 间 才 会 执行 。 比 如 设计 房子 ， 建 筑 师 首先 给 出 指令 一 一 也 就 
是 蓝图 。 这 份 赣 图 经 很 多 人 的 手 ， 过 了 很 长 的 时 间 ， 才 能 建 起 真正 的 
房子 。 所 以 ， 房 子 是 大 家 所 有 人 解读 建筑 师 指令 的 结果 。 相 反 ， 写 程 
序 时 ， 在 我 们 和 计算 机 之 间 没 有 任何 人 。 我 们 让 计算 机 干什么 ， 就 会 
得 到 怎样 的 结果 ;计算 机 绝对 服从 命令 。 结 果 的 质量 完全 取决 于 机 器 
的 质量 、 我 们 想法 的 质量 ， 代 码 的 质量 。 


在 这 三 个 因素 当中 ， 代 码 的 质量 是 如 今 软件 工程 需要 面 对 的 最 重要 问 
题 。 根 据 这 一 点 ， 以 及 上 面 提 到 的 其 他 原因 ， 本 书 的 大 部 分 内 容 都 在 
论述 如 何 提高 代码 质量 。 会 有 一 些 地 方 涉及 机 器 的 质量 和 想法 的 质量 ， 
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但 是 大 多 数 内 容 都 在 论述 怎样 改善 你 交 给 机 器 的 指令 的 结构 和 质量 。 


虽然 伦 了 这 么 多 的 时 间 来 谈 代 码 ， 但 也 很 容易 和 忘记， 改善 代码 质量 
的 一 切 努 力 都 是 为 了 获得 更 好 的 结果 。 本 书 绝 不 姑息 任何 差劲 的 结 
果 一 一 我 们 学 习 提 高 代码 质量 的 全 部 原因 都 在 于 ， 要 想 改进 结果 ， 提 
高 代码 质量 是 最 重要 的 问题 。 


所 以 ， 我 们 最 需要 掌握 的 ， 就 是 提高 代码 质量 的 科学 方法 。 


第 2 章 


缺失 的 科学 


本 书 大 部 分 篇 幅 讲解 的 是 “软件 设计 ”， 你 以 前 可 能 听 过 这 个 词 ， 其 
至 读 过 这 方面 的 书 。 不 过 ， 现 在 请 抛弃 原 有 的 观点 ， 从 全 新 的 、 准 确 
的 定义 开始 ， 重 新 认识 “软件 设计 ”。 


软件 是 什么 ， 我 们 都 知道 ， 因 此 真正 要 定义 的 就 是 “设计 ”了 。 


动词 
(1) 为 创造 性 活动 制订 计划 。 例 句 : 工程 师 本 月 会 设计 一 座 桥梁 ， 下 
个 月 建造 它 。 


名 词 

(1) 为 某 种 创造 性 活动 而 制订 ， 但 尚未 实施 的 计划 。 例 句 : 工程 师 已 

经 确定 了 桥梁 的 设计 ， 下 个 月 建造 它 。 

(2) 业已 存在 的 创造 物 所 遵循 的 计划 。 倒 名: 那 座 桥 的 设计 相当 不 错 。 

谈 到 软件 设计 ， 下 列 这 些 定义 都 适用 。 

。 我 们 “设计 软件 ”( 动 词 “ 设 计 ”) 时 ， 是 在 进行 计划 活动 。 设 计 软 
件 时 要 关心 的 事情 有 很 多 ， 包 括 代码 的 结构 、 所 用 的 技术 等 ， 还 要 
制订 许多 技术 决策 。 通 常 ， 我 们 只 是 在 脑子 里 做 这 些 决 定 ， 有 了 时候 
会 把 它 写 下 来 或 画 出 来 。 

。 上 一 步 的 结果 是 “软件 的 设计 ”( 第 一 种 意义 的 名 词 “设计 ”)， 也 
就 是 计划 。 同 样 ， 它 可 能 是 落实 下 来 的 文档 ， 也 可 能 是 我 们 脑 中 的 
若干 决定 。 

。 已 经 存在 的 程序 同样 有 “设计 ”(〈 第 二 种 意义 的 名 词 “ 设 计 ”)， 也 
就 是 它 的 结构 ， 或 者 它 所 遵循 的 计划 。 有 些 程序 可 能 根本 没有 清楚 
的 结构 ， 所 以 是 “无 设计 ”的 ， 也 就 是 说 开发 它 的 程序 员 没有 任何 
明确 的 计划 。 在 “无 设计 ”和 “完整 的 设计 ”之 间 ， 存 在 着 广阔 的 
灰色 地 带 ， 比 如 “部 分 的 设计 ”、“ 在 某 段 程序 中 存在 的 若干 矛盾 的 
设计 "、“ 接 近 完 成 的 设计 ”等 等 。 一 些 刻意 而 为 的 糟糕 设计 甚至 比 
无 设计 还 要 差劲 。 比 如 你 遇 到 的 那些 刻意 制造 纠结 或 复杂 的 程序 ， 
就 属于 这 类 刻意 而 为 的 糟糕 设计 。 
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软件 设计 的 科学 就 是 为 软件 做 计划 、 制 定 决策 的 科学 ， 忆 
出 这 类 决定 : 


。 程序 的 代码 应 当 采 用 什么 结构 ? 
。 是 程序 的 速度 重要 ， 还 是 代码 容易 阅读 重要 ? 
。 为 满足 需求 ， 应 该 选择 哪 种 编程 语言 ? 


软件 设计 与 下 列 问题 无 关 : 


。 公司 的 结构 应 该 是 怎样 的 ? 

。 什么 时 候 召 开 团 队 会 议 ? 

。 程序 员 的 工作 时 间 应 该 如 何 安 排 ? 
。 程序 员 的 绩效 如 何 考 核 ? 


这 些 决 策 与 软件 本 身 无 关 ， 只 与 组 织 有 关 。 显 然 ， 保 证 这 类 决策 的 合 
理性 也 是 重要 的 一 一 许多 软件 项 目 之 所 以 失败 ， 就 是 管理 失当 。 但 是 
这 不 是 本 书 的 主题 ， 本 书 关注 的 是 ， 如 何 为 你 的 软件 制订 合理 的 技术 
决策 。 


5 助 大 家 做 


QH 
批 


软件 系统 中 任何 与 架构 有 关 的 技术 决策 ， 以 及 在 开发 系统 
中 所 做 的 技术 决策 ， 都 可 以 归 到 “软件 设计 ”的 范畴 里 。 


2.1 程序 员 也 是 设计 师 

在 软件 项 目 中 ， 每 个 程序 员 的 工作 都 与 设计 有 关 。 首 席 程 序 员 负责 设 
计 程 序 的 总 体 架 构 ， 高 级 程序 员 负 责 大 的 模块 ;普通 程序 员 则 设计 自 
己 的 那 一 小 块 ， 其 至 只 是 某 个 文件 的 一 部 分 。 但 是 ， 即 便 仅 仅 是 写 一 
行 代 码 ， 也 包含 设计 的 因素 。 

哪怕 是 单干 ， 也 离 不 开设 计 。 有 时 候 你 在 斋 键 盘 之 前 ， 就 做 了 决定 ， 
这 就 是 在 做 设计 。 有 的 夜晚 ， 你 躺 在 床上 ， 还 在 思考 要 怎样 编程 。 
每 个 写 代 码 的 人 都 是 设计 师 ， 团 队 里 的 每 个 人 都 有 责任 保证 自己 的 代 


码 有 着 良好 的 设计 。 任 何 软件 项 目 里 ， 任 何 写 代码 的 人 ， 在 任何 层面 
上 ， 都 不 能 忽略 软件 设计 。 


这 不 是 说 设计 应 该 采取 民主 程序 进行 。 设 计 决 不 应 该 由 茶 个 委员 会 
责 ， 那 样 的 结果 必然 很 差劲 。 相 反 ， 所 有 的 开发 人 员 都 应 有 权 在 自己 
的 工作 中 做 出 良好 的 设计 决策 。 如 果 某 位 开发 人 员 做 了 糟糕 或 者 平庸 
的 决策 ， 资 深 开 发 人 员 或 者 首席 程序 员 就 应 当 推翻 这 些 决策 ， 重 新 来 
过 。 对 下 属 的 设计 ， 这 些 人 应 当 拥有 否决 权 `。 不 过 ， 软 件 设 计 的 责 
任 应 当 落 实在 真正 写 代 码 的 人 身上 。 


身 为 设计 师 ， 必 须 时 时 愿意 聆听 建议 和 反馈 ， 因 为 程序 员 大 都 比较 聪 
明 ， 有 不 错 的 想法 。 但 是 考虑 了 所 有 这 些 建议 和 反馈 之 后 ， 任 何 决 策 
都 必须 由 单独 的 个 人 而 不 是 一 群 人 来 做 出 。 


2.2 软件 设计 的 科学 


现在 ， 软 件 设计 仍然 不 算 科 学 。 什 么 是 科学 ? 词典 里 的 定义 有 点 儿 复 
杂 ， 但 简单 来 说 ,一 门 学 问 要 成 为 科学 ， 必 须 符合 下 列 标 准 。 


. i oi ee ii 
， 且 这 些 事实 必须 汇总 起 来 (比如 集结 成 书 )。 

. me 吉 构 。 知 识 必 须 能 分 类 ， 其 中 的 各 个 部 分 
Re 

。 科学 必须 包括 一 般 性 的 事实 或 者 基本 的 规则 。 

。 科学 必须 告诉 你 在 现实 世界 中 如 何 做 一 些 事情 。 它 必须 能 够 应 用 到 
工作 或 生活 中 。 

。 通常 ， 科 学 是 经 由 科学 方法 来 发 现 或 证 明 的 。 科 学 方法 必须 观察 现 
实 世界 ， 提 和 炼 出 关于 现实 世界 的 理论 ， 通 过 验证 理论 ， 而 且 这 些 实 
验 必 须 是 可 重复 的 。 这 样 才能 说 明理 论 是 普 适 的 真理 ， 而 不 仅仅 是 
巧合 或 者 特例 。 


注 1: 如 果 你 是 推翻 决策 的 那个 人 ， 这 么 做 的 时 候 应 当 教育 其 他 程序 员 。 你 应 当 说 明 ， 为 
什么 新 决策 比 原来 的 好 。 这 样 下 去 ， 你 以 后 推翻 的 决策 就 会 越 来 越 少 。 有 些 程序 员 
从 来 也 不 学 习 ， 即 便 是 这 样 教育 几 个 月 、 几 年 ， 他 们 还 是 会 做 出 成 堆 的 糟糕 决策 ， 
这 种 人 应 该 清理 出 团队 。 不 过 ， 大 多 数 程 序 员 都 非常 聪明 ， 学 得 很 快 ， 所 以 这 基本 
不 是 一 个 问题 。 
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在 软件 领域 ,我们 已 经 掌握 了 很 多 知识 。 软 件 的 知识 已 经 被 著 书 曾 
述 ,， 已 经 有 了 结构 。 不 过 ， 除 了 成 为 科学 所 必需 的 这 些 条 件 ， 我 们 还 
忽略 了 最 重要 的 部 分 : 清楚 表述 出 来 的 规则 (law)。 规 则 是 恒 常 不 变 
的 事实 ， 一 且 擎 握 了 它们 ， 人 就 不 会 犯错 。 


有 经 验 的 软件 开发 人 员 知 道 怎么 做 才 是 正确 的 。 但 是 为 什么 这 么 做 就 
是 正确 的 ? 判断 正确 和 错误 的 标准 在 哪里 ? 


软件 设计 的 基础 规则 是 什么 ? 


本 书 将 给 出 答案 。 书 中 列 出 了 关于 软件 开发 的 若干 定义 、 事 实 、 规 则 、 
定律 ， 它 们 的 着 眼 点 大 多 在 于 软件 设计 。 可 是 ， 定 义 (Definition)、 
事实 (Facb)、 条 例 (Rule) 、 规 则 (Law) 的 差别 在 哪里 呢 ? 


。 定义 告诉 你 事物 是 什么 ， 应 当 如 何 使 用 。 

。 事实 是 关于 事物 的 真实 陈述 。 每 一 点 真实 的 信息 都 是 事实 。 

。 条 例 是 给 你 的 确切 建议 ， 它 包含 菜 些 具体 的 信息 ， 用 于 制订 决策 。 
但 是 ， 条 例 并 不 能 帮 你 绝对 准确 地 预测 未 来 ， 也 不 能 帮 你 发 现 其 他 
真理 。 它 们 通常 会 告诉 你 是 否 需 要 采取 某 些 行动 。 
规则 是 永远 为 真 的 事实 ， 它 涵盖 了 很 多 领域 的 知识 。 它 们 帮 你 发 现 

其 他 重要 的 真理 ， 帮 你 预测 未 来 要 发 生 的 事情 。 


所 有 这 些 里 面 ， 规 则 是 最 重要 的 。 阅 读 这 本 书 ， 你 会 清楚 地 认识 到 其 
些 规 则 ， 因 为 书 里 会 明确 说 明 。 如 果 你 不 是 很 确定 某 些 信息 应 该 如 何 
归 类 ， 可 以 查看 附录 B， 其 中 列 出 了 本 书 中 所 有 重要 的 信息 ， 并 标注 
了 它 到 底 是 条 例 、 规 则 、 定 义 ， 还 是 普通 的 事实 。 


看 到 这 些 定 义 、 条 例 、 规 则 、 事 实 的 时 候 ， 你 可 能 会 想 :“ 这 些 都 是 
显然 的 ， 我 早 就 知道 了 。” 这 点 不 用 想 也 知道 ， 你 已 经 在 软件 开发 行 


业 里 摸 爬 滚 打 很 入 了 ， 大 概 早 就 遇 到 过 这 些 概念 。 但 是 ， 你 这 么 想 的 
时 候 应 该 问 癌 自己 : 

。 我 是 否 知道 ， 某 些 特定 的 说 法 是 否 经 过 了 证 实 ? 

。 我 是 否 清楚 它 的 重要 性 ? 

。 我 是 否 可 以 向 其 他 人 清楚 讲解 ， 让 对 方 彻 底 明 白 ? 


。 我 是 否 明白 ， 在 软件 开发 领域 中 ， 它 与 其 他 部 分 知识 的 关系 如 何 ? 


如 果 对 某 些 问题 ， 你 曾经 说 过 “不 是 ” “或 者 ”， 但 现在 可 以 说 
“是 ”， 你 就 已 经 有 所 领悟 。 要 区 分 某 些 说 法 到 底 是 科学 ， 或 者 仅 仪 是 
想法 的 集合 ， 这 种 领悟 是 非常 重要 的 。 


当然 ， 科 学 不 等 于 全 知 全 能 。 字 宙 里 还 存在 待 发 现 的 秘密 ， 在 任何 领 
域 都 存在 着 未 知 的 事物 。 有 时 候 ， 发 现 了 新 的 数据 或 者 事实 ， 就 必须 
修正 某 些 基础 规则 。 但 这 正 是 新 的 出 发 点 ! 我 们 可 以 由 此 构筑 科学 : 
关于 开发 软件 的 、 切 合 实际 的 且 能 够 观察 验证 的 规则 和 真理 。 


即便 在 某 天 ， 本 书 的 某 部 分 被 证 明 为 错 的 ， 并 出 现 了 更 完善 更 先进 的 
科学 ， 但 有 一 个 事实 是 很 清楚 的 : 软件 设计 可 以 成 为 科学 。 这 门 学问 
不 是 什么 永恒 的 秘密 ， 因 为 程序 员 在 不 断 成 长 ， 咨 询 顾问 要 把 软件 设 
计 “ 新 方法 ” 拿 出 去 换钱 。 
软件 设计 是 有 章 (规则 ) 可 循 的 ， 它 们 可 以 被 认识 ， 可 以 

被 理解 。 规 则 是 永恒 不 变 的 ， 是 基本 的 事实 ， 而 且 确实 可 行 。 
至 于 本 书 中 的 规则 是 不 是 正确 ， 我 们 可 以 引用 几 百 个 例子 和 试验 来 证 
明 它 ， 不 过 最 终 ， 你 需要 自己 判断 。 请 检验 这 些 规 则 ， 看 看 你 是 否 
能 想到 关于 软件 开发 的 ， 适 用 范围 更 广 或 更 基础 、 更 深入 的 普 适 真 
理 。 如 果 你 有 所 发 现 ， 或 者 找到 了 这 些 规则 的 问题 ， 可 以 登录 http:// 
codesimplicity.com/ 联系 作者 ， 提 供 你 的 贡献 或 问题 。 关 于 这 门 科学 
的 任何 进一步 发 展 ， 都 可 以 让 所 有 人 受益 ， 只 要 新 的 内 容 是 关于 软件 
设计 的 真实 的 、 基 本 的 定律 或 规则 。 


A 人 7 * 4 Ng th 
2.3 为 什么 不 存在 软件 设计 科学 
你 可 能 很 好 奇 ， 这 本 书 诞生 之 前 ， 为 什么 不 存在 软件 设计 的 科学 。 毕 
竟 ， 软 件 开 发 已 经 有 几 十 年 历史 了 。 
让 我 来 讲 个 有 趣 的 故事 吧 。 这 些 背 景 知 识 有 助 于 你 了 解 ， 为 什么 我 们 
跟 计算 机 打 了 这 么 久 的 交道 ， 却 没有 建立 起 软件 设计 的 科学 。 
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今天 的 “计算 机 ”来 源 于 数学 家 的 设计 ， 它 最 初 纯粹 是 一 种 抽象 的 设 
备 ， 数 学 家 想 用 机 器 代 奉 人 脑 来 解数 学 问题 。 


这 些 数 学 家 才 是 计算 机 科学 之 父 ， 计 算 机 科学 正 是 对 信息 处 理 所 做 
的 数学 研究 。 它 并 不 像 现 在 一 些 人 认为 的 那样 ， 是 关于 计算 机 编程 
的 学 间 。 


不 过 ， 最 早 的 计算 机 是 在 计算 机 科学 家 的 指挥 下 、 由 经 验 丰 富 的 电 
子 工程 师 制 造 出 来 的 ， 它 由 受过 专门 训练 的 操作 员 在 严格 控制 的 环 
党 下 操作 。 那 时 的 计算 机 是 为 有 需要 的 机 构 和 部 门 〈 大 多 数 是 政府 
部 门 ， 为 了 计算 弹道 或 者 破解 密码 ) 量 身 定 制 的 ， 每 种 型 号 只 生产 


一 两 台 设 备 。 


然后 UNIVAC 出 现 了 ， 这 是 世界 上 第 一 台 商 用 计算 机 。 当 时 ， 世 界 
上 还 有 足够 多 的 资深 的 理论 数学 家 。 到 了 普通 人 也 买 得 起 计算 机 的 时 
候 ， 已 经 不 可 能 为 每 台 计算 机 配 一 名 数学 家 了 。 有 些 组 织 机 构 ， 比 如 
美国 统计 局 (也 就 是 UNIVAC 的 首 批 客 户 之 一 ) ， 肯 定 是 有 足够 多 的 
受过 严格 训练 的 计算 机 操作 员 的 。 其 他 机 构 则 只 能 先 买 来 机 器 ， 然 后 
说 把 它 交 给 员工 :“ 好 ， 财 务 部 的 Bil， 这 机 器 归 你 了 ， 仔 细 看 看 操作 
手册 ， 让 它 跑 起 来 。” 于 是 Bill 埋头 学 习 这 台 复 杂 的 机 器 ， 尽 可 能 让 
它 跑 起 来 。 


就 这 样 ，Bill 成 为 了 第 一 批 “ 应 用 程序 员 ”。 他 可 能 在 学 校 学 过 数学 ， 
但 是 他 几乎 肯定 没有 学 习 过 设计 和 运行 计算 机 需要 用 到 的 高 深 理 论 。 
不 过 ， 他 可 以 阅读 手册 来 理解 ， 并 通过 试 错 法 让 计算 机 照 自己 的 想法 
工作 。 


然后 ， 商 用 计算 机 卖 得 越 来 越 多 ，Bill 这 样 的 人 也 越 来 越 多 ， 而 严格 
训练 的 操作 员 显 得 越 来 越 少 。 大 多 数 的 程序 员 就 像 Bil 一 样 。 如 果 说 
Bill 有 什么 不 一 样 的 地 方 ， 那 就 是 工作 压力 。 主 管 会 要 求 他 “完成 这 
个 任务 ”， 而 且 会 说 “我 们 不 管 你 怎么 做 ， 总 之 去 做 就 是 了 ”。 他 必须 
根据 说 明 书 ， 想 象 出 该 如 何 完成 任务 ， 然 后 完成 ， 即 便 他 的 程序 每 两 
个 小 时 崩溃 一 次 。 


最 终 ，Bill 带领 一 组 同事 一 起 工作 。 他 必须 能 够 设计 出 系统 ， 并 且 将 
任务 分 派 给 不 同 的 人 。 于 是 ， 实 践 型 编程 的 技艺 不 断 发 展 完善 ， 这 个 
过 程 更 像 大 学 生 的 自学 ， 而 不 是 NASA 的 工程 师 建 造 航天 飞机 。 


在 这 个 阶段 ， 软 件 开 发 就 像 一 锅 大 杂烩 ， 非 常 复 杂 ， 也 难于 管理 ， 但 
是 ， 每 个 人 都 有 点 儿 心 得 。 然 后 出 现 了 Fred Brooks 写 的 《人 月 神 
话 》 探究 了 某 个 实际 的 软件 项 目的 开发 过 程 ， 并 指出 一 些 事实 。 其 
中 最 著名 的 就 是 ， 项 目 延 迟 的 情况 下 ， 增 加 更 多 的 程序 员 ， 只 能 加 剧 
延迟 。Brooks 并 没有 提出 完整 的 科学 ， 但 是 他 对 编程 及 软件 开发 管理 
的 观察 相当 有 价值 。 


这 之 后 诵 现 出 了 大 量 的 软件 开发 方法 : Rational 统一 过 程 、 能 力 成 熟 
度 模型 、 敏 捷 软 件 开发 ， 等 等 。 它 们 无 一 标榜 自己 是 科学 一 一 虽然 它 
们 只 是 管理 软件 开发 复杂 性 的 手段 。 


正 是 这 一 切 ， 导 致 了 现状 : 方法 众多 ， 真 正 的 科学 却 缺 席 。 
其 实 ， 缺 席 的 科学 分 为 两 种 : 软件 管理 的 科学 ， 软 件 设计 的 科学 。 


软件 管理 的 科学 告诉 我 们 的 是 ， 如 何 为 程序 员 分 派 工作 ， 如 何 制订 发 
布 计划 ， 如 何 估量 任务 所 需 的 时 间 ， 诸 如 此 类 。 这 是 一 门 显 学 ， 上 述 
的 各 种 方法 强调 的 正 是 这 一 点 。 在 这 个 领域 中 ， 存 在 着 彼此 矛盾 却 各 
有 道理 的 观点 ， 这 说 明 软 件 管 理 的 基本 规律 尚未 被 认识 。 不 过 ， 大 家 
已 经 关注 到 了 这 个 问题 。 


但 是 ， 软 件 设 计 的 科学 在 现实 的 编程 中 却 没有 什么 人 关注 。 学 校 里 几 
乎 没 人 教导 你 说 ， 软 件 设 计 中 存在 着 科学 。 相 反 ， 大 多 数 人 听 到 的 都 
是 : 编程 语言 就 是 这 样 的 ， 现 在 就 动手 写 代码 吧 。 

本 书 将 要 弥补 这 点 缺憾 。 

本 书 要 讲 的 并 不 是 计算 机 科学 ， 那 属于 数学 研究 。 本 书 提供 的 是 “ 实 
际 干 活 的 程序 员 ” 所 需 科 学 的 入 门 部 分 一 一 在 任何 语言 中 编写 程序 时 
都 应 当 遵 循 的 若干 基础 定律 和 规则 。 这 种 科学 与 物理 和 化 学 一 样 可 
靠 ， 它 告诉 你 如 何 编 写 程序 。 
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据说 ， 这 样 的 科学 是 不 存在 的 ， 软 件 设 计 的 变化 太 多 了 ， 无 法 用 简 
单 、 基 础 的 规则 来 描述 ， 但 这 只 是 一 种 说 法 。 有 些 人 也 说 过 ， 理 解 物 
理 世界 是 不 可 能 的 ， 因 为 “世界 是 神 创 造 的 ， 但 神 是 不 可 知 的 "， 可 
是 我 们 确实 已 经 发 现 了 物理 世界 的 规律 。 所 以 ， 除 非 你 相信 计算 机 是 
不 可 知 的 ， 否 则 ， 软 件 设 计 的 科学 是 必然 会 存在 的 。 


也 有 人 说 ,编程 纯粹 是 一 门 艺 术 ， 服 从 于 程序 员 的 个 人 爱好 。 这 么 说 
有 点 道理 ， 在 科学 应 用 的 任何 领域 ， 都 存在 着 不 少 艺术 的 成 分 ， 但 是 
它们 背后 必然 有 科学 存在 。 只 可 惜 ， 关 于 程序 设计 的 科学 至 今 仍然 是 
一 片 空白 。 


其 实 ， 软 件 复杂 性 的 主要 根源 就 在 于 缺乏 科学 。 如 果 程 序 员 有 科学 指 
导 ， 知 道 该 如 何 开 发 简单 的 软件 ， 就 不 会 有 这 么 多 的 复杂 性 问题 ， 我 
们 也 不 需要 运用 令 人 发 狂 的 过 程 来 管理 这 些 复杂 性 。 


第 3 章 


软件 设计 的 推动 力 


在 编写 程序 时 ， 我 们 应 当知 道 自己 为 什么 要 编程 ， 最 终 目 标 是 什么 。 


有 没有 什么 办 法 ， 可 以 把 各 种 软件 的 目标 都 汇总 到 一 起 ?如 果 有 ， 那 
么 整个 软件 设计 的 科学 就 有 了 方向 ， 因 为 我 们 已 经 知道 自己 要 做 什么 。 


其 实 ， 全 部 软件 都 有 一 个 相同 的 目标 : 

帮助 其 他 人 。! 
依据 具体 的 软件 ， 我们 可 以 得 到 更 加 具体 的 目标 。 比 如 ， 文 字 处 理 软 
件 帮 助 大 家 编辑 文档 ， 浏 览 器 帮助 大 家 浏览 网 页 。 
有 些 软 件 是 帮助 特定 人 群 的 。 比 如 ， 有 许多 审计 软件 给 审计 师 用 ， 此 
类 软件 仅 服务 于 这 一 人 群 。 


那么 ， 服 务 于 动物 或 植物 的 软件 呢 ? 软件 服务 动物 和 植物 的 真正 目 
的 ， 还 是 帮助 人 类 。 


重要 的 是 ， 软 件 从 来 都 不 是 用 来 帮助 无 生命 事物 的 。 软 件 要 帮助 的 不 
是 计算 机 ， 而 是 人 。 即 便 你 写 的 是 程序 库 ， 它 们 也 是 为 程序 员 服 务 
的 ， 程序 员 也 是 人 ， 你 的 服务 对 象 并 不 是 计算 机 。 


“帮助 ”究竟 是 什么 意思 呢 ? 从 某 些 角度 来 看 ， 这 是 个 主观 的 概念 
对 这 个 人 有 帮助 ， 并 不 等 于 对 那个 人 也 有 帮助 。 不 过 词典 里 有 这 个 词 
的 定义 ， 所 以 它 的 定义 并 不 完全 依赖 于 个 人 的 理解 。《 韦 伯 斯 特 新 世 
界 美语 词典 》 里 是 这 么 定义 “帮助 ”的 : 


(让 人 ) 能 更 容易 地 做 某 事 ; 帮忙 ; 协助 。 特 指 完 成 部 分 
工作 ,减轻 或 者 分 担 工 作 量 。 
你 可 以 帮 很 多 人 忙 一 一 做 规划 、 闭 书 、 制 订 食谱 等 。 想 干什么 取决 于 你 ， 
但 目标 都 是 提供 帮助 。 


注 1: 这 个 目标 比 任 何 规则 都 重要 。 在 英语 中 找 不 到 简单 的 词 来 描述 它 ， 我 们 或 许可 以 称 
其 为 “更 高 级 规则 ”， 虽 然 严 格 来 说 它 还 算 不 上 “规则 ”( 比 如 ， 它 不 能 预测 未 来 ) 。 
为 简单 起 见 ， 书 末 附 录 里 把 这 一 目标 归 类 为 规则 ， 其 他 时 候 ， 我 们 称 其 为 “软件 的 
目标 。 
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软件 的 目标 不 是 “赚钱 ”或 者 “炫耀 智商 " 。 不 管 是 谁 ， 只 要 将 这 些 
当成 自己 的 目标 ， 就 偏离 了 软件 的 目标 ， 就 很 可 能 若 上 麻烦 。 即 便 赚 
钱 和 炫 净 智商 可 以 “帮助 ”你 ,但 是 这 只 是 非常 狭隘 的 帮助 ， 相 比 为 
帮助 别人 而 设计 的 、 满 足 其 他 人 需求 的 软件 ， 仅 仅 考 虑 狭 隧 目 标的 设 
计 ， 很 可 能 收获 糟糕 的 软件 。” 


不 理解 “帮助 其 他 人 ”的 程序 员 ， 只 能 写 出 糟糕 的 程序 ， 也 就 是 说 ， 
他 们 的 程序 提供 不 了 什么 帮助 。 实 际 上 ， 大 概 存在 这 么 一 点 理论 ( 根 
据 对 大 量程 序 员 的 长 时 间 观 察 所 得 的 猜想 ) : 一 个 人 写 出 优秀 软件 的 
潜力 ， 完 全 取决 于 他 在 多 大 程度 上 理解 了 “帮助 其 他 人 ”的 思想 。 


总 的 来 说 ， 在 做 与 软件 有 关 的 决策 时 ， 指 导 法 则 就 是 判断 能 提供 什么 
样 的 帮助 (请 记 住 ， 帮 助 有 很 多 种 ， 帮 大 忙 、 帮 小 忙 ， 帮 很 多 人 、 帮 
少数 人 )。 各 项 需求 也 可 以 照 这 个 标准 排出 先后 顺序 。 哪 项 需求 能 为 
人 们 提供 最 大 的 帮助 ， 就 应 当 赋 予 最 高 的 优先 级 。 关 于 需求 的 优先 
级 ， 还 有 很 多 可 以 补充 ， 但 是 在 评估 开发 或 维护 软件 系统 的 建议 时 ， 
“ 它 能 给 用 户 帮 多 少 忙 ”绝对 是 一 个 重要 而 且 基 础 的 问题 。 


总 之 ， 在 设计 软件 时 ， 应 当 将 目标 一 一 帮助 他 人 一 一 视 为 应 该 考虑 的 
最 重要 因素 ， 这 样 ， 我 们 才能 认识 并 了 解 软 件 设计 的 真正 科学 。 


真实 应 用 


如 何 才能 把 软件 的 目标 落实 到 真正 的 项 目 中 去 呢 ? 举 个 例子 吧 ， 假 
设 我 们 要 为 程序 员 开 发 一 款 文 本 编辑 器 。 首 先 需要 决定 的 就 是 软 
件 的 目的 。 这 个 目的 最 好 要 简单 ， 不 妨 先 定位 “帮助 程序 员 编 辑 文 
本 ”。 更 具体 一 点 也 没 问 题 ， 甚 至 有 时 候 会 更 好 。 如 果 开 发 人 员 对 
更 具体 的 目标 尚 存 分 歧 ， 且 从 最 简单 的 形式 开始 吧 。 


注 2: 没 错 ， 你 当然 可 以 把 “赚钱 ”当成 自己 或 者 公司 的 目标 ， 这 无 可 厚 非 ， 但 它 不 应 该 
是 你 的 软件 的 目标 。 任 何 情况 下 ， 你 所 赚 的 钱 都 直接 维系 于 你 的 软件 能 为 他 人 提供 
多 少 帮助 。 事 实 上 ， 决 定 软件 公司 收入 的 两 个 主要 因素 基本 就 是 组 织 水 平 (包括 行 
政 、 管 理 、 推 广 、 销 售 等 方面 )， 以 及 软件 对 他 人 的 帮助 。 


既然 目标 确定 了 ， 来 看 所 有 需要 完成 的 功能 吧 。 针 对 每 一 条 功能 ， 

我 们 都 要 问 自己 : “这 个 功能 怎样 帮助 程序 员 编 辑 文本 呢 ? ”如果 

答案 是 没什么 帮助 ， 功 能 就 应 当 马 上 取消 。 这 样 检 查 过 一 遍 之 后 ， 

对 剩 下 的 每 个 需求 ， 要 写 下 一 个 短 身 作为 答案 。 人 假设， 有 人 要 求 我 

们 为 常用 操作 提供 快捷 键 。 我 们 应 该 这 么 记 : “快捷 键 可 以 帮助 程 

序 员 编辑 文本 ， 因 为 有 了 快捷 键 ， 程 序 员 不 用 浪费 时 间 输 入 ， 他 们 

与 程序 交互 的 速度 提高 了 。” (你 不 一 定 要 写 下 来 ， 如 果 写 下 来 显 

得 多 余 ， 只 要 保证 自己 明和 白 这 一 点 就 好 了 。) 

之 所 以 要 这 样 问 自己 ， 是 因为 还 存在 其 他 有 价值 的 理由 。 

。 这 样 思 考 ， 有 助 于 澄清 功能 描述 或 实现 方式 中 的 模糊 之 处 。 上 
面 关 于 快捷 键 的 描述 说 明 ， 它 的 响应 必须 很 快 ， 因 为 快捷 键 的 
价值 就 在 这 里 。 

。 这 样 思 考 ， 有 助 于 团队 确认 功能 的 价值 。 有 些 人 可 能 不 喜欢 快 
捷 键 , 但 是 每 个 人 都 应 该 认同 上 面 关于 其 价值 的 解释 。 事 实 上 ， 
有 些 开 发 人 员 会 想 出 更 好 的 办 法 来 满足 客户 的 需求 (进一步 提 
高 操作 文本 编辑 器 的 速度 )， 而 不 需要 快捷 键 ， 这样 也 是 没有 
问题 的 。 如 果 问 题 的 答案 可 以 引出 更 好 的 想法 ， 就 应 该 去 实现 
那个 更 好 的 想法 。 问 题 的 答案 告诉 我 们 的 是 真实 的 需求 ， 而 不 
是 用 户 以 为 的 需求 。 

。 这 样 思 考 ， 某 些 功能 会 凸显 出 更 重要 的 价值 。 这 有 助 于 项 目 领 
导 分 配 优先 级 。 

。 退 一 万 步 说 ， 如 果 编 辑 器 因为 堆 登 了 过 多 功能 而 脓肿 ， 可 以 根 
据 这 些 答 案 决 定 删 减 哪些 功能 。 

我 们 还 需要 列 一 张 bug 清 单 ， 方 便 检 查 和 反思 : 这 个 pug 如 何 影响 程 

序 员 编 辑 文 本 ? 有 时 候 答 案 很 明显 ， 那 么 也 不 需要 写 下 来 : 比如 你 

要 保存 文件 的 时 候 程序 崩 汪 了， 就 不 需要 画蛇添足 地 解释 为 什么 前 

渍 是 不 好 的 。 

要 把 软件 的 目标 落实 到 真正 的 工作 中 ， 还 有 很 多 办 法 ， 这 里 只 给 出 

了 几 个 例子 。 
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软件 设计 科学 的 目标 
了 解 了 软件 设计 的 目标 之 后 ， 就 可 以 确定 软件 设计 的 科学 的 基本 方 
向 了 。 


从 目标 看 ， 我 们 知道 开发 软件 是 为 了 帮助 其 他 人 。 所 以 ， 软 件 设计 科 
学 的 目标 应 该 是 : 


确保 软件 能 提供 尽 可 能 多 的 帮助 。 


其 次 ， 我 们 通常 希望 软件 可 以 给 大 家 提供 持续 的 帮助 。 所 以 ， 第 二 个 
目标 是 : 


确保 软件 能 持续 提供 尽 可 能 多 的 帮助 。 


这 个 目标 相当 伟大 ， 但 是 ， 不 管 是 什么 软件 系统 ， 也 不 管 规模 多 大 ， 
它 都 是 非常 复杂 的 ， 所 以 确保 持续 提供 帮助 其 实 是 个 挑战 。 实 际 上 ， 
在 今天 ， 编 号 和 维护 有 帮助 的 软件 的 主要 障碍 在 于 设计 和 编程 。 如 果 
软件 很 难 开发 或 修改 ， 程 序 员 的 主要 精力 就 花 在 让 软件 “能 用 ”上 ， 
而 没有 精力 去 帮助 用 户 。 如 果 系 统 易于 修改 ， 程 序 员 就 会 有 更 多 的 余 
力 去 帮助 用 户 ， 不 必 费 心 于 编程 细节 。 同 样 道理 ， 软 件 的 维护 难度 越 
低 ， 程 序 员 确保 软件 能 持续 提供 帮助 的 难度 也 越 低 。 
于 是 ,我 们 得 到 了 第 三 个 目标 ; 
设计 程序 员 能 尽 可 能 简单 地 开发 和 维护 的 软件 系统 ， 这 样 

的 系统 才能 为 用 户 提供 尽 可 能 多 的 帮助 ， 而 且 能 持续 提供 尽 可 

能 多 的 帮助 。 
传统 上 认为 ， 这 第 三 个 目标 就 是 软件 设计 的 目标 ， 虽 然 从 来 也 没有 人 
这 么 清晰 地 表述 过 。 不 过 ， 第 一 个 和 第 二 个 目标 的 指引 是 非常 重要 
的 。 我 们 需要 记 住 ， 推 动 实现 第 三 个 目标 的 ， 就 是 确保 软件 现在 能 提 
供 帮助 ， 将 来 仍然 能 帮助 。 


关于 第 三 个 目标 ， 需 要 特别 指出 的 是 “ 尽 可 能 简单 ”的 说 法 。 它 的 意 
思 是 软件 的 开发 和 维护 都 应 当 简 单 ， 要 避免 困难 或 复杂 。 这 并 不 是 


说 ， 任 何事 从 一 开始 就 要 简单 ， 有 时 候 ， 学 习 新 技术 ， 做 一 份 好 的 设 
计 ， 都 要 花 很 长 时 间 ， 但 是 长 期 来 看 ， 你 做 出 的 选择 必须 确保 开发 和 
维护 软件 都 比较 简单 。 


有 时 候 ， 第 一 个 目标 〈 确 保有 帮助 ) 和 第 三 个 目标 〈 维 护 简单) 是 有 
点 冲突 的 ， 为 了 确保 有 帮助 ， 维 护 难度 就 会 增加 。 不 过 纵 观 历史 ， 这 
两 个 目标 冲突 的 原因 往往 并 不 是 如 此 。 开 发 出 完全 可 维护 、 对 用 户 极 
为 有 用 的 软件 ， 有 绝对 的 事实 依据 。 其 实 ， 如 果 你 不 能 确保 软件 的 可 
维护 性 ， 就 很 难 实现 第 二 个 目标 ， 也 就 不 能 持续 提供 帮助 。 这 样 看 
来 ， 第 三 个 目标 是 非常 重要 的 ， 否 则 我 们 就 没 办 法 完成 前 两 个 目标 。 
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软件 设计 师 面 对 的 主要 问题 是 :“ 在 设计 软件 时 ， 应 该 做 怎样 的 决 
定 ? ” 面 对 的 众多 可 能 ， 哪 一 个 才 是 最 好 的 。 我 们 不 是 要 确定 绝对 的 
好 坏 ， 而 是 要 知道 :“ 这 些 可 能 的 选择 中 ， 哪 些 更 好 ? ”这 是 个 排序 
问题 ， 我 们 要 做 的 是 从 所 有 可 能 中 选 出 最 好 的 决定 。 举 个 例子 ， 设 计 
师 可 能 癌 自 己 :“ 摆 在 眼前 的 功能 有 100 项 ， 但 我 们 的 人 力 只 能 够 完 
成 2 项 。 应 该 选 哪 2 项 呢 ? “ 


fy * 4 下 * 
4.1 软件 设计 的 方程 式 
上 面 的 问题 ， 还 包括 软件 设计 的 本 质 中 的 所 有 问题 ， 都 可 以 用 下 面 的 
方程 式 来 解答 : 


UD 
ll 
< 


其 中 : 


D 表示 这 个 变化 的 合意 程度 (可 取 程 度 )。 我 们 对 此 项 工作 的 需求 有 
多 么 迫切 ? 


V 表示 它 的 价值 。 该 变化 价值 几何 ?一 般 来 说 ， 你 可 以 问 自己 “这 个 
变化 对 用 户 有 多 少 用 ;当然 ， 还 有 很 多 其 他 方法 来 判断 其 价值 。 


表示 完成 这 个 变化 的 成 本 ， 也 就 是 完成 它 需 要 付出 的 代价 。 


所 以 ， 这 个 等 式 的 意思 是 : 


(sul 


任何 一 点 改变 ， 其 合意 程度 与 其 价值 成 正比 ， 与 所 付出 的 
成 本 成 反比 。 

这 并 不 是 在 判断 某 个 变化 绝对 对 错 ， 而 是 指导 你 如 何 分 辩 并 排序 你 的 
选项 。 能 带 来 较 大 价值 、 花 费 成 本 较 少 的 变化 ， 要 比 带 来 较 少 价值 、 
花费 较 多 成 本 的 变化 “更 好 ”。 

哪怕 你 的 问题 是 “我 们 是 否 应 当 维持 不 变 "， 也 可 以 通过 这 个 方程 式 
得 到 答案 。 你 可 以 问 自 己 “ 维 持 不 变 的 价值 何在 ”或 者 “维持 不 变 需 
要 花 什么 成 本 ”， 再 对 比 进行 改变 的 价值 和 成 本 的 比率 。 
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4.1.1 价值 
方程 式 中 的 “价值 ” 指 什么 ? 价值 最 简单 的 定义 是 : 

这 个 变化 能 带 给 人 多 大 帮助 。 
所 有 需要 帮助 的 人 里 面 ， 最 重要 的 是 你 的 用 户 。 不 过 ， 为 了 赚 更 多 钱 
而 开发 基 些 功能 ， 也 是 一 种 形式 的 价值 一 一 对 你 来 说 有 价值 。 其 实 ， 
创造 价值 的 方式 有 很 多 种 ， 上 面 只 是 举 两 个 例子 。 
要 准确 衡量 某 点 变化 所 创造 的 价值 ， 有 了 时候 是 很 难得 。 如 果 你 的 软件 
可 以 帮 人 减肥 ， 你 怎么 精确 衡量 帮 人 减肥 的 价值 ? 这 是 做 不 到 的 。 不 
过 你 可 以 知道 的 是 ， 软 件 的 基 些 功能 可 以 帮 人 减 掉 不 少 体 重 ， 有 些 功 
能 则 对 减肥 完全 无 效 。 到 头 来 ， 你 还 是 可 以 根据 价值 来 为 变化 排序 。 
判断 每 一 点 可 能 的 变化 的 价值 ， 基 本 的 依据 是 开发 人 员 的 开发 经 验 ， 
还 包括 对 用 户 做 恰当 的 研究 ， 找 到 对 他 们 帮助 最 大 的 工作 。 


1. 价值 可 能 性 和 潜在 价值 
价值 由 两 部 分 组 成 : 可 能 价值 〈 这 个 变化 有 多 大 可 能 帮 有 到 用 户 )、 湾 在 
价值 〈 这 个 变化 在 对 用 户 提供 帮助 的 时 候 ， 将 为 用 户 提供 多 大 的 帮助 ) 。 


举例 来 说 : 


。 某 个 功能 可 以 延长 人 的 寿命 ， 即 便 只 有 百 万 分 之 一 的 可 能 性 ， 这 也 

仍然 是 非常 有 用 的 功能 。 它 的 蕉 在 价值 很 高 《延寿 ) ， 可 能 价值 非 

常 低 。 

再 举 个 例子 ， 你 可 以 为 电子 表格 程序 添加 功能 ， 以 便 育 人 输入 数 
盲人 只 占用 户 的 很 小 一 部 分 ， 但 如 果 没 有 这 个 功能 ， 他 们 就 根 

本 没 法 使 用 你 的 程序 。 同 样 ， 这 个 功能 是 有 价值 的 ， 因 为 其 闹 在 价 

值 很 高 ， 尽 管 它 只 对 一 小 部 分 用 户 有 用 (可 能 价值 很 低 )。 

能 够 让 所 有 用 户 都 微笑 的 功能 确实 是 有 价值 的 。 其 潜在 价值 很 低 

(只 能 让 人 微笑 ) ， 但 是 它 能 影响 到 很 多 人 ， 所 以 它 的 可 能 价值 非 


i 


是 FJ o 


1 


。 反 过 来 ， 如 果 你 完成 的 某 项 功能 ， 只 有 百 万 分 之 一 的 可 能 性 让 某 
人 微笑 ， 那 么 它 并 没 多 少 价值 。 这 项 功能 的 潜在 价值 和 可 能 价值 
都 很 低 。 


所 以 ， 在 判断 价值 时 ， 你 应 该 考虑 : 


。 多 少 用 户 ( 占 多 大 比例 ) 会 从 此 项 工作 中 受益 ? 

。 此 功能 对 用 户 有 价值 的 可 能 性 有 多 大 ? 或 者 换个 说 法 : 此 功能 发 挥 
价值 的 频率 有 多 高 ? 

。 在 它 发 挥 价值 的 时 候 ， 它 能 发 挥 出 多 大 的 价值 ? 


2. 平衡 危害 


有 些 改变 在 带 来 帮助 的 同时 也 会 带 来 麻烦 。 如 果 你 的 程序 要 展示 广 
告 ， 就 会 让 某 些 人 觉得 烦 ， 虽 然 展 示 广 告 可 以 为 开发 提供 资金 。 


权衡 改变 的 价值 ， 需 要 衡量 它 可 能 造成 的 危害 ， 并 权衡 利 次 。 


3. 赢得 用 户 的 价值 
如 果 某 个 功能 找 不 到 用 户 ， 就 不 存在 实际 的 价值 。 这 些 功能 可 能 用 户 
找 不 到 ， 或 者 很 难 使 用 ， 或 者 根本 就 帮 不 上 任何 人 。 在 将 来 它们 可 能 
有 价值 ， 但 目前 没有 。 


这 也 意味 着 ， 大 多 数 情况 下 ， 为 了 确保 你 的 软件 有 价值 ， 就 必须 真正 
发 布 它 。 如 果 某 个 变化 花费 的 时 间 太 长 ， 最 后 可 能 就 没有 任何 价值 ， 
因为 它 不 能 及 时 发 布 ， 无 法 给 人 提供 切实 的 帮助 。 在 判断 某 项 工作 的 
合意 程度 时 ， 评 估 其 发布 计划 是 非常 重要 的 。 


4.1.2 成 本 

比 起 价值 ， 成 本 更 容易 量化 一 点 。 通 常 ， 你 可 以 计算 “需要 多 少 个 人 工 
作 和 多少 小 时 ”。 经 常 听 到 的 关于 成 本 的 量化 表述 是 “100 人 年 "， 它 表示 
1 个 人 工作 100 年 ， 或 者 100 个 人 工作 1 年 , 或 者 50 个 人 工作 2 年 。 


尽管 成 本 可 以 量化 ， 落 实 起 来 却 相 当 复 杂 ， 基 至 是 不 可 能 的 。 有 些 变 
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化 包含 隐形 成 本 ,难于 预测 ， 比 如 花 在 修正 开发 某 项 功能 造成 的 bug 
上 的 时 间 就 很 难 预测 。 不 过 ， 经 验 直 富 的 软件 开发 人 员 仍 然 可 以 在 不 
需要 知道 确切 数值 的 情况 下 ， 根 据 可 能 成 本 来 预测 。 


预测 某 个 变化 的 成 本 时 ， 重 要 的 是 要 考虑 牵涉 到 的 所 有 投入 ， 而 不 仅 
仅 是 编程 的 时 间 。 研 究 要 花 多 少时 间 ? 开发 人 员 之 间 的 沟通 要 花 多 少 
时 间 ? 所 做 的 思考 要 花 多 少时 间 ? 


简单 说 ， 与 这 个 变化 有 关 的 每 一 点 时 间 ， 都 是 成 本 的 一 部 分 。 


4.1.3 维护 

到 目前 为 止 ,这 个 方程 式 还 非常 简单 ， 但 它 忽略 了 一 个 重要 的 因 
素 一 一 时 间 。 你 不 但 需要 完成 这 个 变化 ， 还 需要 一 直 维 护 它 。 所 有 的 
变化 都 需要 维护 。 有 些 工 作 显 而 易 见 要 做 维护 : 如 果 你 开发 一 款 计算 
报税 的 软件 ， 每 年 的 新 规定 公布 之 后 ， 你 都 必须 升级 。 即 使 这 项 工作 
暂时 看 不 到 长 期 的 维护 成 本 ， 即 使 维护 成 本 只 是 你 下 一 年 必须 再 做 一 
次 测试 ， 维 护 成 本 仍然 存在 。 


我 们 还 必须 考虑 现在 价值 和 未 来 价值 。 修 改 现 有 的 系统 时 ， 受 益 的 是 
现在 的 用 户 ， 但 是 它 也 可 能 帮助 到 未 来 的 用 户 ， 甚 至 可 能 影响 到 未 来 
的 用 户 数目 ， 进 而 影响 到 现 有 系统 究竟 总 共 能 帮助 到 多 少 人 。 

有 些 功能 的 价值 会 随时 间 变 化 。 举 例 来 说 ，2009 年 的 税收 计算 软件 在 
2009 年 和 2010 年 是 有 价值 的 ， 但 到 了 2011 年 就 要 打折 扣 了 。 这 就 是 
随时 间 变 化 而 贬值 的 功能 。 还 有 些 功能 会 随时 间 变 化 而 增值 。 

所 以 ， 脚 踏实 地 来 看 这 个 问题 ， 我 们 会 发 现 ， 成 本 包含 实现 成 本 和 维 
护 成 本 ， 价 值 也 包括 当前 价值 和 未 来 价值 。 用 方程 式 来 表示 就 是 : 


EB=E+E, 
st a 


其 中 : 
E; 代表 实现 成 本 


局, 代表 维护 成 本 
,代表 当前 价值 
V 代表 未 来 价值 


4.1.4 完整 的 方程 式 
考虑 所 有 因素 ， 完 整 的 方程 式 就 是 : 


p= 信 + 
Fit+ En 


用 文字 说 明 就 是 : 
改变 的 合意 程度 (可 行 性 ) ,正比 于 软件 当前 价值 与 未 来 
价值 之 和 ， 反 比 于 实现 成 本 和 维护 成 本 之 和 。 
这 就 是 软件 设计 的 最 重要 规律 。 不 过 ， 还 需要 做 一 些 补充 说 明 。 


4.1.5 化 简 方程 式 

“未 来 价值 ”和 “维护 成 本 ”都 取决 于 时 间 ， 如 果 把 这 个 方程 式 应 用 
到 现实 中 ， 随 着 时 间 的 改变 ， 会 出 现 非常 有 意思 的 现象 。 为 说 明 这 个 
问题 ， 假 设 价值 和 成 本 都 可 以 用 金钱 来 衡量 。“ 价 值 ”衡量 的 是 这 项 
工作 能 带 来 多 少 钱 ,“ 成 本 ”衡量 的 是 为 完成 这 项 工作 需要 投入 多 少 
钱 。 在 真实 世界 中 不 应 当 这 样 处 理 ， 但 就 这 个 例子 而 言 ， 这 么 做 可 以 
起 到 简化 作用 。 


好 ， 假 设 要 完成 工作 对 应 的 方程 式 是 这 样 : 
$10 000 + $10 000/ 天 

$1000 + $100/ 天 

这 项 工作 要 花 1000 美元 完成 (实现 成 本 , 分母 的 第 1 项 )， 能 马上 带 
来 10 000 美元 的 收益 (当前 价值 ， 分 子 的 第 1 项 )。 之 后 每 一 天 ， 它 
都 能 带 来 1000 美元 收益 〈 未 来 价值 ， 分 子 的 第 2 项 )， 而 且 需 要 花 
100 美元 来 维护 (维护 成 本 ,分 母 的 第 2 项 ) 。 


到 第 10 天 ， 累 积 的 未 来 价值 是 10 000 美元 ， 累 积 的 维护 成 本 是 1000 


力 王 
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美元 。 这 也 相当 于 之 前 说 的 “当前 价值 ”和 维护 成 本 ， 只 是 时 间 在 10 
天 后 而 已 。 


在 100 天 后 ， 未 来 价值 一 共 是 100 000 美元 ， 维 护 成 本 是 10 000 美元 。 


在 1000 天 后 ， 未 来 收益 总 计 为 100 万 美元 ， 维 护 成 本 总 计 为 10 万 
美元 。 这 时 候 ， 最 开始 说 的 “当前 价值 ”和 维护 成 本 看 来 就 微不足道 
了 。 随 着 时 间 的 流逝 ， 它 会 越 来 越 不 重要 ， 甚 至 完全 无 足 轻重 。 于 
是 ， 随 着 时 间 流 逝 ， 这 个 方程 式 变 成 了 : 

Vr 

其 实 ， 儿 乎 所 有 软件 设计 的 决策 都 完全 忽略 了 未 来 价值 与 维护 成 本 的 
对 比 。 有 时 候 当 前 价值 和 实现 成 本 足够 大 ， 始 终 在 决策 中 占有 决定 性 
地 位 ， 但 是 这 种 情况 很 少见 。 一 般 来 说 ， 软 件 系统 都 需要 维护 很 长 时 
间 ， 大 多 数 情况 下 ， 未 来 长 期 收益 和 维护 成 本 才 是 真正 需要 考虑 的 ， 
与 之 相 比 ， 当 前 价值 和 实现 成 本 变 得 无 足 轻 重 。 


4.1.6 ”你 需要 什么 ， 不 需要 什么 

我 们 已 经 学 到 了 重要 的 一 课 ， 也 就 是 要 避免 这 样 的 情况 : 对 某 项 工 
作 ， 维 护 成 本 最 终 大 大 超过 未 来 的 收益 。 假 设 你 完成 其 项 工作 ， 在 5 
天 内 ， 它 的 成 本 和 价值 看 起 来 是 这 样 的 ， 


天 数 成 本 价值 


防守 


1 $10 $1000 

所 $100 $100 

3 $1000 $10 

4 $10 000 $1 

5 $100 000 $0.10 
总 计 $111 110 $1111.10 


显然 ， 这 是 一 项 非常 精 糕 的 工作 ， 千 万 不 要 这 么 干 。 如 果 按 照 这 个 势 


注 1: 补充 说 明 ， 如 果 学 过 微 积分 ， 你 可 能 会 认识 到 ， 我 们 正在 分 析 这 个 等 式 在 时 间接 近 
无 穷 时 的 极限 。 通 常 来 说 ， 你 应 该 把 软件 设计 的 方程 式 理解 为 一 个 具有 极限 的 无 穷 
数列 ， 而 不 是 某 个 静态 方程 式 。 不 过 ， 为 简单 起 见 ， 现 在 先 按 静 态 方程 式 来 考虑 。 


头 持续 下 去 ， 系 统 根 本 无 法 维护 一 一 它 会 变 得 无 比 昂 贵 ， 而 每 天 都 没 
有 产生 收益 。 


无 论 如 何 ， 只 要 维护 成 本 的 增长 速度 比价 值 快 ， 你 就 会 遇 到 麻烦 ， 即 
便 刚 开始 的 情况 是 这 样 的 : 


天 数 成 本 价值 


1 $1000 $1000 

2 $2000 $2000 

3 $4000 $3000 

4 $8000 $4000 

总 计 $15 000 $10 000 

理想 的 解决 方案 一 一 也 即 保证 成 功 的 唯一 途径 一 一 就 是 这 样 设计 你 自 


系统 : 保证 维护 成 本 随时 间 降 低 ， pm 
只 要 你 人 BE 做 到 这 点 Re 0 
从。 比如 ， 下 表 所 示 就 是 合意 的 情 ; 


天 数 成 本 价值 

1 $1000 $0 

2 $100 $10 

3 $10 $100 

4 $0 $1000 
5 $0 $10 000 
总 计 $1110 $11 110 
天 数 成 本 价值 

1 $20 $10 

2 $10 $10 

3 $5 $10 

4 $1 $10 

5 $0 $10 
总 计 $36 $50 


能 带 来 更 高 未 来 价值 的 改变 仍然 是 更 可 取 的， 不 过 ， 只 要 每 项 决策 
的 维护 成 本 都 会 随时 间 降 低 到 接近 于 零 ， 未 来 你 就 不 会 陷 人 危险 的 
况 地 。 


理想 情况 下 ， 只 要 未 来 收益 高 于 维护 成 本 ,工作 就 是 值得 做 的 。 所 
以 ， 哪 怕 维 护 成 本 和 未 来 收益 都 增加 ， 只 要 未 来 收益 超过 维护 成 本 ， 
也 是 值得 做 的 。 


天 数 成 本 价值 


1 $1 $0 
2 $2 $2 
3 $3 $4 
4 $4 $6 
5 $5 $8 
总 计 $15 $20 


这 样 的 工作 也 不 错 ， 但 是 更 合意 的 是 这 样 的 工作 : 虽然 实现 成 本 很 
高 ， 维 护 成 本 却 会 下 降 。 如 有 果 维护 成 本 会 随时 间 推 移 而 逐步 降低 ， 这 
项 工作 就 会 变 得 越 来 越 有 价值 。 所 以 我 们 才 说 这 样 做 更 合意 。 


通常 来 说 ， 如 果 要 设计 一 个 系统 ， 其 维护 成 本 能 逐渐 降低 ， 需 要 在 实 
现 上 花 很 高 的 成 本 ， 做 相当 多 的 设计 和 规划 。 不 过 请 记 住 ， 在 设计 决 
策 中 ， 实 现成 本 通常 并 不 是 重要 的 因素 ， 所 以 基本 可 以 忽略 。 


简 而 言 之 : 


相 比 降低 实现 成 本 ， 降 低 维 护 成 本 更 加 重要 。 
在 软件 设计 的 科学 中 ， 这 是 非常 重要 的 一 点 。 
但 是 维护 成 本 从 哪里 来 ? 怎样 设计 系统 ， 才 能 保证 维护 成 本 会 随时 间 
推移 而 降低 ? 本 书 剩 下 的 篇 幅 ， 大 部 分 讲 的 都 是 这 个 主题 。 但 是 在 开 
台 之 前 ， 先 要 对 未 来 做 更 细致 的 检查 。 


4.2 设计 的 质量 

如 今 ， 要 写 出 一 款 能 帮助 某 个 人 的 软件 ， 实 在 是 太 容 易 了 。 但 是 ， 要 
写 出 能 帮助 几 百 万 人 ,而 且 是 在 未 来 几 十 年 里 持续 提供 这 种 帮助 的 软 
件 ， 则 要 难得 多 。 那 么 ， 编 程 中 的 大 部 分 精力 应 该 花 在 哪里 ? 大 多 数 
人 会 在 什么 时 候 使 用 这 款 软件 ? 现在 ， 还 是 未 来 的 几 十 年 ? 


答案 是 ， 相 比 现在 ， 将 来 有 多 得 多 的 编程 工作 要 做 ， 也 有 更 多 的 用 户 
要 帮助 。 在 未 来 ， 你 的 软件 必须 保持 竞争 力 ， 才 能 继续 存在 ， 同 时 ， 
维护 成 本 和 用 户 数量 也 会 增加 。 


如 果 我 们 忽视 事实 ， 放 弃 对 未 来 的 思考 ， 只 考虑 当 下 “能 用 ”的 软 
件 ， 那 么 我 们 的 软件 在 未 来 就 会 很 难 维护 。 如 果 软 件 很 难 维护 ， 就 很 
难 确保 它 能 够 帮助 别人 (而 这 正 是 软件 设计 的 目标 )。 如 果 你 不 能 添 
加 新 功能 ， 也 不 能 修正 问题 ， 你 最 后 得 到 的 就 是 “糟糕 的 软件 ”"。 它 
不 能 帮 到 用 户 ， 而 且 满 身 问题 。 


于 是 ， 可 以 得 到 这 条 规律 : 

设计 的 质量 好 坏 ， 正 比 于 该 系统 在 未 来 能 持续 帮助 他 人 时 

间 的 长 度 。 

如 果 你 的 软件 只 能 在 未 来 几 小 时 内 提供 帮助 ， 就 不 需要 花 太 多 的 工夫 
去 设计 。 如 果 需 要 在 未 来 10 年 内 都 能 派 上 用 场 (这 个 时 间 通 常会 超过 
你 的 预期 ， 虽然 你 很 可 能 只 打算 保证 能 用 6 个 月 )， 就 需要 花 很 多 精力 
去 设计 。 如 果 举 棋 不 定 ， 不 妨 设 想 它 要 使 用 很 长 很 长 的 时 间 ， 然 后 按 
照 这 个 设想 去 设计 。 不 要 把 自己 禁 铀 在 某 种 工作 定 势 里 ， 要 保持 灵活 ， 
不 要 做 任何 以 后 无 法 改变 的 决策 ;在 设计 时 要 慎重 , 慎重， 再 慎重 。 


4.3 不 可 预测 的 结果 
现在 我 们 知道 了 ， 设 计 软 件 时 最 应 该 关注 的 是 未 来 。 不 过 ， 关 于 任何 
工程 ， 都 有 一 点 极为 重要 : 
未 来 的 某 些 事情 ， 是 我 们 所 不 知道 的 。 
其 实 ， 软 件 设 计 也 是 如 此 ， 关 于 未 来 ， 大 多 数 事情 都 是 未 知 的 。 


程序 员 犯 的 最 常见 也 是 最 严重 的 错误 ， 就 是 在 其 实 不 知道 
未 来 的 时 候 去 预测 未 来 。 
假设 ，1985 年 有 个 程序 员 编 了 个 修理 软盘 错误 的 程序 。 这 个 程序 不 能 
修理 其 他 任何 东西 一 一 因为 它 的 每 个 部 分 都 是 专门 针对 软盘 的 工作 原 
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理 和 状态 而 考虑 的 。 到 现在 ， 这 个 软件 肯定 没 用 了 ， 因 为 已 经 没有 人 
用 软盘 了 。 程 序 员 的 预期 是 “人 们 会 一 直 使 用 软盘 ”一 一 但 其 实 他 并 
不 确切 知道 这 一 点 。 


预测 短期 未 来 是 可 能 的 ， 但 长 期 未 来 基本 是 未 知 的 。 可 是 ， 相 比 短 
期 长 期 的 未 来 对 我 们 来 说 更 重要 ， 因 为 我 们 的 设计 决策 会 在 未 来 更 
长 的 时 间 里 产生 更 大 的 影响 。 


峙 全 


如 果 完 全 不 考虑 未 来 ， 只 根据 当前 已 知 的 确切 信息 确定 所 
4 4 。 有 设计 决策 ， 那 就 百 分 百 安全 了 。 
人 
这 个 说 法 听 起 来 与 本 章 之 前 说 的 相 了 矛盾 ， 甚 实 并 非 如 此 。 在 进行 决策 
时 ， 未 来 才 是 最 重要 的 事情 。 但 在 进行 决策 时 ， 考 虑 未 来 的 变数 和 堂 
试 预测 未 来 ， 是 有 区 别 的 。 


打 个 比方 ， 你 要 做 个 简单 的 抉择 ， 是 吃 东 西 还 是 饿 死 。 这 并 不 需要 预 
测 未 来 才 可 以 决策 一 一 你 当然 知道 吃 东 西 是 更 好 的 决策 。 为 什么 ? 因 
为 这 样 你 可 以 活 下 去 ， 而 且 将 来 可 以 过 得 更 好 ， 饿 死 了 就 没有 未 来 可 
言 了 。 未 来 是 重要 的 ， 在 做 决策 时 需要 考虑 它 。 选 择 吃饭 ， 是 因为 它 
可 以 带 来 更 好 的 未 来 。 但 是 ， 未 来 并 不 需要 预测 一 一 我 们 不 需要 知道 
确切 的 未 来 ， 比 如 “我 要 吃 东西 ， 因 为 明天 我 得 救 一 个 孩子 。 只 要 
你 选择 吃饭 ， 而 不 选择 饿 死 ， 无 论 明天 发 生 什么 ， 都 比 饿 死 要 好 。 


同样 道理 ， 在 软件 设计 时 ， 可 以 根据 已 知 的 信息 做 某 些 决策 ， 目 的 是 


为 了 创造 更 好 的 未 来 《提升 价值 ， 降 低 维护 成 本 ) ， 而 不 必 有 预测 未 来 
究竟 会 发 生 什 么 具体 的 事情 。 


当然 ， 也 有 少量 例外 ， 有 时 候 你 确切 知道 未 来 短期 内 会 发 生 什 么 ， 便 
可 以 据 此 决策 。 如 果 这 么 做 ， 必 须 对 未 来 有 相当 的 把 握 ， 而 且 这 种 未 
来 必须 触手 可 及 。 无 论 你 多 聪明 ， 肯 定 没 有 简单 的 办 法 准确 预测 长 期 
未 来 。 


举 个 编程 之 外 的 例子 。CD 诞生 于 1979 年 ， 最 初 设想 是 取代 磁带 ， 成 
为 最 主要 的 听 音 媒质 。 谁 能 预计 到 20 年 之 后 会 出 现 同样 尺寸 的 DVD， 


所 以 计算 机 上 会 出 现 同 时 兼容 CD/DVD 的 驱动 器 ? 谁 又 可 以 预计 到 ， 
当 CD-ROM 以 50 倍速 读 取 CD 时 ,会 出 现 什么 问题 ? 


正 是 因为 如 此 ， 任 何 工 程 一 一 包括 软件 开发 一 一 都 有 “指导 原则 ”。 如 


采 我 们 遵循 这 些 原则 ， 


无 论 未 来 发 生 什 么 ， 一 切 事情 都 会 按部就班 。 


这 就 是 软件 设计 的 规律 和 法 则 ， 也 是 我 们 这 些 设 计 师 的 “指导 原则 ”。 


是 的 ， 重 要 的 是 要 记 住 ， 存 在 着 未 来 。 但 是 ， 这 不 要 求 你 必须 预测 未 
来 ， 它 只 是 说 明 你 为 什么 应 当 遵循 本 书 的 规则 和 条 例 来 决策 一 一 因为 


无 论 未 来 会 发 生 什么 ， 


它们 总 可 以 保证 你 的 软件 不 偏离 正轨 。 


事实 上 ， 某 条 特定 的 规则 和 条 例 在 未 来 会 以 什么 样 的 方式 帮助 你 也 无 
法 预测 一 一 但 是 它 确 实 能 帮 上 忙 ， 而 且 你 会 欣然 乐意 把 它们 应 用 在 工 


作 中 。 
尔 当 然 有 权 不 同意 本 


中 读 到 的 规则 。 关 于 规则 ， 你 一 定 要 有 自己 的 


看 法 。 但 是 你 应 当 谨 记 ， 如 采 不 遵守 这 些 规 则 ， 你 很 可 能 在 无 法 预测 


的 未 来 落得 一 团 糟 。 


未 来 | 39 


第 5 章 


变化 


现在 我 们 已 经 知道 了 未 来 的 重要 性 ， 也 知道 了 关于 未 来 有 些 东西 是 我 
们 不 知道 也 不 可 能 知道 的 ， 那 么 ， 有 什么 是 确定 的 呢 ? 


可 以 确定 的 一 点 是 ， 随 着 时 间 的 流 碑 ， 软 件 所 处 的 环境 会 变化 。 没 有 
东西 可 以 永恒 不 变 。 也 就 是 说 ， 软 件 必须 随 环境 变化 而 变化 ， 才 能 适 
应 所 处 的 环境 。 


于 是 ,我们 得 到 了 变化 定律 (Law of Change): 


程序 存在 的 时 间 越 久 ， 它 的 某 个 部 分 需要 变化 的 可 能 性 就 
越 高 。 
未 来 是 无 穷 无 尽 的 ， 所 以 可 以 百 分 百 地 肯定 ， 最 终 ， 程 序 的 每 个 部 分 
都 必须 变化 。 在 未 来 5 分 钟 里 ， 可 能 没有 哪个 部 分 需要 变化 ， 在 未 来 
10 天 里 ， 某 个 小 部 分 可 能 需要 变化 ， 在 未 来 20 年 ， 即 便 不 是 全 部 都 
必须 变化 ， 很 可 能 大 部 分 也 必须 变化 。 


哪些 部 分 会 发 生变 化 很 难 预测 ， 为 什么 要 变化 也 很 难 预 测 。 很 可 能 你 
的 程序 是 为 4 轮 轿 车 写 的 ， 可 未 来 每 个 人 都 开 着 18 轮 的 大 卡车 ;很 
可 能 你 的 程序 是 写 给 高 中 生 的 ， 但 是 高 中 教育 的 质量 会 差 到 没有 学 生 
懂 你 的 程序 。 

关键 在 于 ， 你 并 不 需要 去 预测 什么 会 变化 ， 你 需要 知道 的 是 ， 变 化 必 
然 会 发 生 。 程 序 应 该 保证 尽 可 能 合理 的 灵活 性 ， 这 样 ， 不 管 未 来 发 生 
什么 变化 ， 都 可 以 应 付 得 了 。 


[KT pail’ 
5.1 真实 世界 中 程序 的 变化 
来 看 一 份 关 于 真正 的 程序 随时 间 流 逝 而 变化 的 数据 吧 。 某 个 程序 包含 
数 百 个 文件 ， 但 是 一 页 篇 幅 列 不 完 所 有 的 文件 ， 所 以 这 里 选取 了 4 个 
文件 作 样 本 。 表 5-1 列 出 了 它们 的 变化 详情 。 
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表 5-1 随时 间 流 逝 的 文件 变化 


文件 1 文件 2 文件 3 文件 4 
分 析 时 常 5 年 2 个 月 8 年 3 个 月 13 年 3 个 月 13 年 4 个 月 
初始 行 数 423 192 227 309 
未 变化 行 数 271 101 4 8 
当前 行 数 644 948 388 414 
增长 数 241 756 161 105 
变化 次 数 47 99 194 459 
新 增 行 数 396 1026 913 3838 
删除 行 数 ” 155 270 752 3723 
修改 行 数 ”124 413 1382 3556 
总 变化 行 数 675 1709 3047 11107 
变化 率 1.6x 8.9x 13x 36x 


表 中 各 项 指标 解释 如 下 。 


分 析 时 长 : 文件 存在 的 时 间 长 度 。 

初始 行 数 ， 文件 最 初 包含 多 少 行 。 

未 变化 行 数 : 与 最 初 相 比 ， 没 有 变化 的 行 数 。 

当前 行 数 : 该 分 析 周 期 结束 时 ， 文 件 的 行 数 。 

变化 数 :“ 当 前 行 数 ”与 “最 初 行 数 ” 之 间 的 差额 。 

变化 次 数 : 程序 员 修改 文件 的 次 数 〈 一 次 更 改 可 以 涉及 多 行 )。 通 党 
一 次 对 应 着 一 次 bug 修正 或 者 添加 一 项 新 功能 等 。 

新 增 行 数 : 总 的 来 看 ， 文 件 累计 新 增 了 多 少 行 。 

删除 行 数 : 总 的 来 看 ， 文 件 累 计 删除 了 多 少 行 。 

修改 行 数 : 总 的 来 看 ， 文 件 累计 修改 了 多 少 行 。 

总 变化 行 数 : 新 增 行 数 、 删 除 行 数 、 修 改行 数 的 总 和 。 

变化 率 :“ 总 变化 行 数 ” 与 “最 初 行 数 ” 之 间 的 比率 。 

上 面 所 说 的 “ 行 数 "， 包 含 文件 的 每 一 行 : 代码 、 注 释 、 文 档 、 空 行 。 
如 果 忽 略 注释 、 文 档 、 空 行 ， 就 会 发 现 一 处 显著 差别 :“ 未 变化 行 数 ” 
会 比 其 他 几 个 指标 少 得 多 (也 就 是 说 ， 未 变化 的 行 儿 乎 都 是 注释 、 文 


看 这 张 表 格 ， 应 当 弄 清楚 的 最 重要 一 点 是 ， 在 一 个 软件 项 目 中 ， 许 多 
变化 会 发 生 。 随 着 时 间 的 流 返 ， 代 码 的 每 一 行 都 需要 修改 的 概率 越 来 
越 大 ， 然 而 ， 你 并 不 能 精确 预测 要 修改 什么 ， 什 么 时 候 要 修改 ， 或 者 
要 修改 多 少 。 这 4 个 文件 的 变化 方式 各 不 相同 〈 只 看 数字 也 可 以 发 现 
这 点 ) ， 但 是 它们 都 发 生 了 相当 大 的 变化 。 


关于 这 些 指标 ， 还 有 一 些 有 趣 的 补充 。 


。 观察 变化 率 可 以 发 现 , 修改 文件 的 工作 量 比 最 初 写 文件 时 的 还 要 大 。 
当然 ， 行 数 这 个 指标 不 能 准确 反映 工作 量 ， 但 是 它 可 以 体现 一 般 趋 
势 。 有 时 候 变化 率 很 高 ， 比 如 ,文件 4 的 总 变化 行 数 是 初始 行 数 的 
36 倍 。 

。 每 个 文件 中 的 未 变化 行 数 ， 比 起 “初始 行 数 ”都 是 相当 小 的 ， 比 起 
“当前 行 数 ”来 就 更 小 了 。 

。 文件 随时 间 逐 渐 增长 只 是 一 方面 ， 还 有 很 多 其 他 变化 。 比 如 ， 文 件 
3 在 13 年 后 只 有 161 行 ， 但 是 总 变化 行 数 却 有 3047。 

。 总 变化 行 数 通 常 比 当前 行 数 要 大 。 也 就 是 说 ， 如 果 文 件 已 经 存在 了 
足够 长 的 时 间 ， 你 通常 会 去 做 修改 ， 而 不 是 新 增 代码 。 

。 观察 文件 3 的 指标 可 以 发 现 ， 修 改行 数 要 多 于 原始 行 数 与 新 增 行 数 之 
和 。 相 比 新 增 一 行 ， 修 改 已 有 某 行 的 频率 更 高 。 也 就 是 说 ， 文 件 中 有 
一 些 行 是 反复 修改 的 。 如 果 项 目 持续 的 时 间 很 长 ， 这 是 常见 的 情况 。 

以 上 列 出 的 只 是 部 分 的 信息 ， 关 于 这 些 数字 ， 还 可 以 做 其 他 许多 有 趣 

的 分 析 。 我 们 鼓励 你 去 探究 这 些 数 据 (或 者 是 分 析 自 己 项 目 里 的 类 似 

外 标 ) 来 取得 进一步 的 收获 。 


另 一 点 值得 学 习 的 有 趣 之 处 是 ， 回 顾 某 个 特定 文件 修改 历 
"4 ，。 史 。 如 果 某 个 文件 存在 了 很 长 时 间 ， 而 且 你 有 程序 记录 每 
个 文件 的 修改 历史 ， 请 回顾 整个 过 程 中 的 每 次 修改 。 问 问 
自己 ， 最 初 写 这 个 文件 时 ， 你 能 预测 到 这 些 变化 吗 ， 是 否 
一 开始 写 好 就 能 够 减轻 后 期 的 工作 量 。 总 的 来 说 ， 就 是 要 
尝试 理解 每 次 修改 ， 看 看 是 否 能 从 中 得 到 一 些 关 于 软件 开 
发 的 新 的 收获 。 


人 7 :3 和 — 入 
5.2 软件 设计 的 三 大 误区 
为 了 适应 变化 定律 ， 软 件 设 计 师 常 常会 掉 进 误区 。 其 中 有 3 个 误区 最 
常见 ， 这 里 按照 其 发 生 频 率 逐 一 列 出 来 : 
(1) 编写 不 必要 的 代码 
(2) 代码 难以 修改 
(3) 过 分 追求 通用 


5.2.1 编写 不 必要 的 代码 

如 今 ， 软 件 设计 中 有 一 条 常见 的 规则 ， 叫 做 “你 不 会 需要 它 ”(You 
Ain’t Gonna Need It), 或 者 简称 为 YAGNI。 其 实 这 条 规则 的 意思 
是 ， 不 应 该 在 真正 的 需求 来 临 之 前 编写 那些 代码 。 这 条 规则 相当 不 
错 ， 但 名 字 取 错 了 。 将 来 你 可 能 真 的 需要 这 些 代 码 ， 但 是 既然 不 能 预 
测 未 来 ， 就 不 知道 现在 该 怎么 使 用 这 些 代 码 。 如 果 现 在 就 编写 这 些 代 
码 ， 却 不 知道 该 怎么 用 ， 等 到 你 真 的 需要 使 用 时 ， 就 得 重新 设计 。 所 
以 应 当做 的 是 ， 省 下 重新 设计 的 时 间 ， 等 到 真正 需要 的 时 候 再 编写 那 
些 代 码 。 


在 需求 来 临 之 前 就 编写 代码 的 另 一 点 危险 是 ， 当 前 用 不 到 的 代码 很 可 
能 会 导致 “劣化 ” 。 因 为 代码 从 来 没有 用 到 ， 它 很 可 能 与 系统 的 其 他 
部 分 脱节 ， 继 而 产生 bug， 可 是 你 永远 也 不 知道 。 最 终 等 你 想 去 使 用 
的 时 候 ， 就 得 花 时 间 去 排 错 。 更 糟糕 的 是 ， 你 很 可 能 相信 这 些 从 来 没 
用 过 的 代码 是 正确 的 而 忽略 了 检查 ， 这 样 bug 就 留 给 了 用 户 。 甚 实 ， 
这 条 规则 应 当 这 样 展开 : 


不 要 编写 不 是 必需 的 代码 ， 并 且 要 删除 没有 用 到 的 代码 。 


也 就 是 说 ， 你 还 需要 删除 所 有 用 不 到 的 代码 ， 如 果真 的 需要 ， 你 随时 
可 以 恢复 回来 。 


注 1: bit rot， 这 是 一 个 技术 术语 ， 意 指 随 时 间 推 移 ， 软 件 劣 化 或 者 丢失 数据 的 现象 。 
一 一 译 者 注 
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出 于 一 些 其 他 原因 ， 还 是 有 人 会 认为 他 们 应 当 现 在 就 编写 一 些 今后 才 
会 需要 的 代码 ， 或 者 是 保留 暂时 用 不 到 的 代码 。 有 些 人 相信 自己 可 以 
抗拒 变化 定律 ， 只 要 某 个 功能 现在 有 任何 一 名 用 户 可 能 用 到 ， 就 为 此 


编写 代码 。 这 样 一 来 ， 程 序 在 未 来 就 不 需要 改变 或 改进 了 。 但 是 ， 


这 


样 做 是 不 对 的 。 只 要 一 直 有 人 用 ， 就 没有 什么 系统 可 以 永远 保持 不 变 。 
还 有 人 认为 ， 现 在 多 做 些 工 作 ， 将 来 就 可 以 节省 时 间 。 有 的 场合 下 这 种 
做 法 行 得 通 ， 但 这 不 包括 写 没 人 用 的 代码 的 情况 。 即 便 这 些 代 码 将 来 可 
以 派 上 用 场 ， 多 半 也 得 要 花 时 间 重 新 设计 ， 所 以 最 终 还 是 浪费 了 时 间 。 


编写 不 必要 的 代码 : 真实 的 例子 


从 前 ， 有 位 开发 人 员 就 叫 他 Max 吧 一 一 以 为 自己 可 以 不 受 这 条 规 
则 的 束缚 。 他 的 程序 里 有 一 项 下 拉 菜 单 ， 用 户 可 以 从 中 选取 一 个 值 。 
使 用 该 软件 的 每 家 公司 都 会 自己 定制 这 个 菜单 的 选项 。 有 些 公司 定制 
的 选项 可 能 是 颜色 的 名 字 ， 还 有 些 可 能 是 城市 的 名 字 ， 当 然 还 有 其 他 
选项 。 所 以 ， 可 供 选择 的 项 应 当 存 储 在 每 家 公司 都 可 以 修改 的 地 方 。 
显然 ， 存 储 可 供 选择 的 值 就 够 了 。 上 毕竟 ， 需 要 做 的 就 是 这 些 。 但 是 
Max 决 定 多 走 一 步 : 既 要 保存 每 个 选项 值 ， 又 要 记录 每 个 值 当前 是 
否 “可 用 ”一 一 也 就 是 说 ， 用 户 现在 能 否 选择 这 些 选 项 ， 这 个 值 是 
否 临 时 禁用 了 。 

不 过 ，Max 一 直 没 写 任何 判断 选项 是 否 “ 可 用 ”的 代码 。 自 始 至 终 ， 
无 论 存 储 了 什么 数据 ， 所 有 的 选择 都 是 可 用 的 。 虽 然 Max 以 为 他 马上 
就 要 写 那些 判断 “可 用 ”的 代码 了 ， 没 准 儿 就 在 第 二 天 动手 。 

几 年 过 去 了 ,判断 “可 用 ”数据 的 代码 一 直 没 有 出 现 。 相 反 ， 数 据 
只 是 存在 那里 ， 没 有 任何 地 方 用 到 ， 却 会 干扰 其 他 人 的 认 知 ， 产 生 
错误 。 许 多 客户 和 开发 人 员 写 信 给 Max， 想 询问 为 什么 他 们 把 若干 
选项 设 定 为 “不 可 用 ”状态 时 ， 没 有 任何 变化 。 有 一 名 开发 人 员 错 
误 地 假设 “可 用 ”字段 是 有 用 的 ， 划 至 写 了 些 代码 来 使 用 它 ， 即 便 
系统 的 其 他 部 分 都 没有 用 到 。 修 改 后 的 程序 到 了 客户 手 里 ， 客 户 就 
开始 报告 奇怪 的 问题 ， 需 要 花 大 力气 来 追踪 。 


最 后 ， 有 些 开发 人 员 要 动手 了 ， 他 们 告诉 自己 : 今天 就 要 实现 禁用 
选项 的 功能 。 但 是 他 们 发 现 ，“ 可 用 ”字段 的 设计 并 不 能 满足 自己 
的 需求 ， 所 以 他 得 花 相当 多 的 时 间 重 新 设计 才能 实现 这 个 功能 。 

最 终 的 结果 是 : 若干 bug， 严 重 的 混 清 视听 和 困扰 ， 真正 需 要 这 段 
代码 的 开发 人 员 还 得 做 大 量 的 工作 。 这 还 不 算是 严重 违背 规律 的 行 
为 ! 倘若 严重 违背 这 条 规律 ， 会 导致 更 加 恶劣 的 后 果 ， 包 括 项 目 延 
期 ， 造 成 巨大 的 灾难 ， 整 个 项 目 甚 至 会 因此 完蛋 。 


5.2.2 ”代码 难以 修改 


软件 项 目的 一 大 杀手 就 是 所 谓 的 “僵化 设计 ”(rigid design)。 也 就 是 
说 ， 程 序 员 写 出 来 的 代码 很 难 修改 。 僵 化 设计 有 两 大 原因 : 


(1) 对 未 来 做 太 多 假设 
(2) 不 仔细 设计 就 编写 代码 


举例 : 太 多 关于 未 来 的 假设 


一 家 机 构 就 叫 “ 老 兵 医院 ” 吧 希望 开发 一 个 程序 。 他 们 叫 
它 “ 医 疗 保健 系统 ”。 在 设计 该 系统 之 前 ， 医 院 决定 编制 文档 详细 
说 明 整 个 系统 的 实现 细节 ， 他 们 花 了 一 年 来 写 这 份 文 档 ， 确 定 系统 
中 的 每 一 点 决策 。 


然后 ， 开 发 人 员 依 照 文档 ， 花 了 3 年 把 系统 开发 出 来 。 在 开发 时 ， 
他 们 发 现 文 档 中 的 设计 有 地 方 自 相 了 矛盾 ， 有 地 方 不 完整 ， 还 有 地 方 
很 难 实现 。 可 是 这 份 文 档 是 医院 花 了 一 整 年 编写 的 ， 所 以 开发 人 员 
不 能 再 等 一 年 让 医院 来 修订 。 于 是 ， 开 发 人 员 还 是 尽 可 能 按照 文档 
完成 了 整套 系统 。 

系统 完成 之 后 就 进行 了 首次 交付 。 但 是 现在 ， 医 院 的 情形 已 经 大 不 
相同 了 。 距 离 最 初 的 设计 已 经 过 去 了 四 年 ， 用 户 真 正 使 用 这 套 系 统 
时 ， 发 现 自己 需要 的 已 经 完全 不 同 了 。 人 然而 系统 是 由 几 十 万 行 代码 
构成 的 ， 其 设计 也 是 严格 按照 文档 来 构建 的 ， 除 非 再 花 上 几 个 月 其 
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至 几 年 ， 否 则 系统 很 难 改变 。 

所 以 ， 公 司 开始 为 新 系统 重 写 设计 文档 ， 把 之 前 的 过 程 重新 来 过 。 
医院 的 错误 就 在 于 他 们 试图 预测 未 来 。 他 们 假设 文档 中 所 作 的 每 一 
点 改动 都 是 对 最 终 用 户 真 正 有 用 的 ， 而且 到 系统 完成 的 时 候 还 会 
一 直 有 用 。 未 来 真 的 到 来 时 ， 却 完全 与 之 前 预测 的 不 一 样 ， 结 果 几 
百 万 美元 打 了 水 漂 。 


更 好 的 办 法 是 每 次 只 确定 一 个 或 者 少数 几 个 需求 ， 然 后 立刻 让 开发 人 
员 实 现 它 。 在 开发 过 程 中 ， 用 户 可 以 扮演 开发 人 员 的 角色 ， 反 复 进 
行 沟通 。 上 次 确定 的 功能 实现 并 发 布 之 后 ， 就 可 以 继续 处 理 其 他 的 功 
能 。 这 样 ， 最 终 得 到 的 系统 是 设计 良好 的 ， 完 全 满足 用 户 需 求 的 。 


举例 : 缺乏 设计 的 编码 


某 开 发 人 员 被 要 求 写 一 个 程序 ， 供 人 们 记录 他 们 完成 任务 的 进度 。 
为 了 在 系统 里 新 建 一 个 任务 ， 用 户 需 要 在 表单 里 填写 某 些 信息 ， 
比如 任务 的 概要 信息 、 现 在 的 进度 。 这 些 信 息 存 储 在 数据 库 里 。 然 
后 ， 随 着 时 间 的 推移 ， 大 家 一 点 点 地 记录 任务 的 进展 ， 最 终 标注 自 
已 完成 了 整个 任务 。 


软件 里 有 个 叫 Status 的 字段 ， 用 来 记录 当前 任务 的 进度 。 这 个 字段 的 
值 有 No Work Done (未 做 ) ，In Progress (进行 中 ) ，On Hold ( 暂 
停 ) ，Complete (完成 ) 。 如 果 值 为 No Work Done， 只 能 改 为 In 
Progress。 如 果 值 为 In Progress， 只 能 改 为 On Hold 或 者 Complete。 如 
果 值 为 Complete， 只 可 以 改 回 为 In Progress。 


程序 里 还 有 其 他 10 个 字段 需要 用 到 类 似 的 规则 ， 每 个 都 包含 任务 某 
一 方面 的 信息 (比如 指派 给 谁 、 截 止 日 期 是 哪 天 ) 。 

为 实现 这 些 规则 ， 程 序 员 专门 写 了 一 段 长 长 的 代码 ， 它 没有 任何 
结构 ， 而 是 独立 保存 为 一 个 文件 。 这 段 代码 验证 每 个 字段 的 正确 
性 ， 也 仅 为 完成 验证 功能 而 设计 。 比 如 ， 每 次 检查 状态 是 否 为 


Complete， 就 在 代码 里 硬 编码 写 上 Complete。 同 样 ， 编 写 代 码 时 也 
不 考虑 重用 。 遇 到 相似 的 字段 ， 开 发 人 员 就 复制 -粘贴 代码 ， 然 后 
有 针对 性 地 做 些小 修改 。 


这 段 代 码 当 然 能 用 。 文 件 有 3000 行 ， 但 基本 与 设计 绝缘 。 
几 个 月 过 去 了 ， 开 发 人 员 离 开 了 项 目 。 


之 后 ， 一 名 新 开发 人 员 被 安排 来 维护 这 个 项 目 。 他 很 快 发 现 这 段 代 
码 很 难 修改 ， 如 果 修 改 其 中 的 一 部 分 ， 就 得 对 其 他 很 多 地 方 做 同样 
的 修改 ， 才 能 保证 程序 正常 运行 。 更 糟糕 的 是 ， 这 些 类 似 的 部 分 分 
得 很 散 ， 既 没有 注释 ， 也 没有 远 辑 一 一 每 次 需要 修改 时 ， 除 了 阅读 
整个 文件 外 别 无 他 法 。 

然后 ， 客 户 要 求 添加 新 的 功能 。 一 开始 ， 新 来 的 这 名 开发 人 员 尽 自 
已 努力 来 完成 新 功能 ， 他 在 文件 中 增加 了 更 多 代码 。 代 码 行 数 达 到 
了 5000 行 。 


最 终 ， 客 户 要 求 的 某 些 功能 ， 原 有 设计 方案 已 经 无 法 实现 了 。 客 户 
希望 用 电子 邮件 更 新 任务 的 进度 ， 但 是 原 有 代码 只 能 处 理 表单 。 原 
有 的 设计 是 紧密 地 与 表单 绑 定 的 一 一 它 无 法 对 接 电子 邮件 。 

这 时 候 ， 竞 争 对 手 出 现 了 ， 他 们 的 任务 可 以 用 电子 邮件 来 更 新 。 结 
果 ， 原 有 的 软件 开始 流失 容 户 。 

这 个 项 目 之 所 以 能 维持 下 去 ， 完 全 是 因为 有 两 名 开发 人 员 花 了 一 整 年 
重新 设计 了 这 个 文件 ， 降 低 了 它 的 修改 难度 。 在 重新 设计 时 ， 他 们 尽 
自己 努力 来 满足 其 他 新 需求 ， 但 大 多 数 时 间 还 是 花 在 重新 设计 上 。? 


要 避免 僵化 设计 ， 就 应 当做 到 


设计 程序 时 ， 应 当 根 据 你 现在 确切 知道 的 需求 ， 而 不 是 你 
认为 未 来 会 出 现 的 需求 。 


2: Bugzilla 中 的 这 个 文件 叫 process_bug.cgi。 这 个 故事 做 了 删 略 ， 但 是 数字 (也 就 是 
代码 的 行 数 ， 以 及 用 来 修复 的 时 间 ) 却 是 大 致 准确 的 。 如 果 你 想 看 关于 重新 设计 整 
个 项 目的 完整 故事 ， 看 看 这 一 切 是 怎么 发 生 的 ， 可 以 参考 这 个 链接 : https://bugzilla. 
mozilla.org/showdependencytree.cgi?id=367914&hide_resolved=0。 
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基于 当前 确 知 的 需求 来 设计 ， 同 时 兼顾 未 来 需求 的 可 能 性 。 如 果 你 确 
切 地 知道 ， 系统 需要 完成 又， 而 且 只 是 X， 那 么 现在 设计 时 就 应 该 只 
考虑 完成 X。 你 应 该 记 住 ， 未 来 系统 可 能 还 要 提供 X 之 外 的 功能 ， 但 
是 现在 ， 系 统 只 应 该 完成 X。 

如 果 照 这 样 来 设计 ， 另 外 应 该 做 到 的 一 点 是 ， 保 持 每 次 改变 的 幅度 都 
很 小 。 如 果 要 做 的 改变 很 小 ， 设 计 的 难度 也 会 很 小 。 

这 不 是 说 不 要 做 规划 。 在 软件 设计 中 ， 一 定 程 度 的 规划 是 非常 有 价值 
的 。 但 是 ， 即 便 不 做 详细 的 规划 ， 只 要 你 能 保持 改变 的 幅度 很 小 ， 代 
码 也 很 容易 适应 不 确定 的 未 来 ， 就 没有 大 的 风险 。 


5.2.3 ”过 分 追求 通用 

既然 代码 将 来 要 修改 是 一 个 事实 ， 有 些 开 发 人 员 给 出 的 应 对 方案 就 
是 : 做 一 个 足够 通用 的 办 法 ， 保 证 (他们 自己 相信 ) 可 以 适应 未 来 任 
何 可 能 的 形势 。 我 们 称 这 种 做 法 为 “过 度 工程 ”(overengineering ) 。 


按照 字典 的 定义 ，overengineering 就 是 over (意思 是 “过 分 了 ”) 加 
engineer (意思 是 “设计 和 构造 ")。 根 据 这 种 解释， 过 度 工程 意思 就 
是 ,在 设计 或 者 构造 上 花 了 过 多 的 精力 。 


等 一 下 ， 设 计 和 构建 过 多 了 ? 什么 是 “过 多 ”? 设计 不 是 一 件 好 事 
吗 ? 


是 的 ， 大 多 数 工程 都 应 该 在 设计 上 花 更 多 的 精力 ， 在 上 一 节 中 “ 举 
例 : 缺乏 设计 的 编码 ”中 已 经 看 到 这 点 。 但 是 总 会 有 人 真 的 掉 到 过 度 
工程 的 陷阱 里 一 一 就 如 同 为 了 烧毁 蚁 穴 ， 就 去 制造 一 台 轨 道 激光 器 。 
轨道 激光 器 是 有 相当 挑战 的 工程 ， 它 耗费 不 菲 ， 制 造 时 间 相 当 长 ， 维 
护 起 来 也 是 一 场 慎 梦 。 你 能 想象 它 出 问题 的 时 候 应 当 怎 么 修复 吗 ? 


过 度 工程 还 有 其 他 儿 个 问题 。 


(1) 因为 你 不 能 预测 未 来 ， 所 以 无 论 你 做 得 多 么 通用 ， 其 实 都 不 够 满 
足 未 来 要 面 对 的 真实 需求 。 
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(2) 如 果 你 的 代码 很 通用 ， 那 么 它 通常 不 能 从 用 户 的 角度 很 好 地 满足 规 
格 / 需求。 举例 来 说 ,假设 你 设计 的 代码 把 所 有 输入 都 当成 二 进 制 字 
节 来 对 待 。 有 时 候 这 代码 要 处 理 文本 ， 有 时 候 要 处 理 图 片 ， 但 是 它 只 
知道 输入 的 是 字 闻 。 某 种 方面 来 说 ， 这 种 设计 不 错 : 代码 足够 简单 、 
自 洽 、 短 小。 然后 你 才 知 道 ， 代 码 根本 无 法 区 分 图 片 和 文本 一 一 这 就 
是 过 分 通用 了 。 用 户 传 进来 一 张 损坏 的 图 片 ， 得 到 的 错误 却 是 “ 传 入 
的 字 节 错误 "。 本 来 它 应 该 报告 “图 片 已 经 损坏 "， 但 是 你 的 代码 太 过 
通用 ， 无 法 给 出 这 种 提示 ( 太 过 通用 的 代码 很 多 时 候 无 法 满足 具体 的 


需求 ， 这 只 是 一 个 例子 )。 
(3) 太 过 通用 就 必须 写 很 多 不 需要 的 代码 ， 这 样 又 回 到 了 第 一 条 规律 。 


总 的 来 说 ， 如 果 你 的 设计 让 事情 更 复杂 而 不 是 变 简单 ， 就 是 在 做 过 度 
工程 。 如 果 你 只 需要 清理 蚁 穴 ， 动 用 轨道 激光 就 会 把 事情 大 大 搞 复 
杂 ， 其 实 只 用 一 点 蚂蚁 药 就 可 以 解决 问题 (假设 它 有 效 )。 


在 追求 通用 时 ， 应 当选 择 正确 的 事情 ， 选 择 正确 的 方法 ， 这 是 成 功 的 
软件 设计 的 基础 。 然 而 ， 太 过 通用 ， 会 带 来 说 不 完 的 复杂 和 混乱 ， 也 
会 大 大 抬 高 维护 成 本 。 避 免 此 误区 的 办 法 ， 和 避免 僵化 设计 的 一 样 : 


仅仅 根据 目前 确 知 的 需求 来 考虑 通用 。 


举例 : 太 过 通用 
某 程 序 的 某 个 部 分 的 功能 是 ， 用 户 填 写 一 张 表 单 ， 程 序 就 发 送 几 百 
封 邮件 。 这 个 部 分 的 程序 运行 起 来 很 慢 。 用 户 提 交 表 单 之 后 ， 程 序 
会 在 这 个 环节 停留 很 长 时 间 ， 等 待 发 送 完 所 有 的 邮件 。 
为 了 提高 这 个 环节 的 速度 ， 开 发 人 员 决 定 不 要 立即 发 送 所 有 的 邮 
件 ， 而 是 改 为 在 后 台 发 送 。 用 户 提交 了 表单 之 后 ， 程 序 会 使 用 之 前 
存在 的 “Email Sender” 代码 来 发 送 邮件 。 
负责 这 个 任务 的 开发 人 员 认 为 有 些 公司 并 不 会 使 用 Email Sender。 
他 写 了 几 百 行 代码 ， 这 样 用 户 就 可 以 把 其 他 系统 以 插件 的 方式 塞 进 
来 ， 在 后 台 执 行 这 个 任务 。 从 没有 客户 提 过 这 个 需求 ， 开 发 人 员 只 
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是 猜测 未 来 会 有 人 要 求 这 种 灵活 性 。 

最 终 ， 首 席 架构 师 叫 停 了 这 种 做 法 。 他 去 撞 了 所 有 与 “插件 ”有 关 
的 代码 ， 因 为 根本 没有 证 据 表明 有 人 会 那么 用 。 也 就 是 说 ， 没 有 任 
何 证 据 表明 目前 代码 需要 做 到 那么 通用 。 这 些 代码 删 掉 之 后 ， 修 改 
变 得 容易 多 了 。 

这 一 改变 已 经 过 去 了 四 年 ， 期 间 没 有 任何 客户 要 求 给 系统 做 插件 。 
也 就 是 说 ， 系 统 其 实 根本 没有 必要 做 得 那么 通用 。 


5.3 ”渐进 式 开发 及 设计 
有 个 办 法 可 从 根本 上 避免 这 三 大 误区 ， 这 就 是 “渐进 式 开发 和 设计 "。 
它 要 求 按照 特定 顺序 ， 一 点 一 点 地 设计 和 构建 系统 。 


这 个 办 法 很 容易 举例 来 说 明 。 假 如 需要 开发 可 以 计算 加 减 乘 除 的 计算 
器 程序 。 


(1) 设计 一 个 只 能 进行 加 法 运算 的 系统 。 

(2) 实现 它 。 

(3) 修改 现 有 设计 ， 很 容易 就 可 以 支持 减法 运算 。 

(4) 实现 减法 运算 。 现 在 ， 系 统 只 能 进行 加 、 减 运算 。 

(5) 再 次 修改 现 有 系统 的 设计 ， 很 容易 就 可 以 支持 乘法 运算 。 

(6) 实现 乘法 运算 功能 。 现 在 的 系统 可 以 支持 加 、 减 、 乘 运算 了 。 

(7) 再 次 修改 系统 的 设计 ， 添 加 除法 运算 (现在 做 这 一 步 应 该 不 需要 
花 多 少 功 夫 了 ， 因 为 我 们 早 就 改进 了 设计 ， 添 加 过 减法 、 乘 法 )。 

(8) 实现 除法 功能 。 这 时 候 得 到 的 就 是 一 开始 期 望 构建 的 完整 系统 ， 
而 且 拥 有 满足 需求 的 恨 好 设计 。 


相 比 开始 就 建立 完整 的 系统 ， 一 次 性 构建 出 来 ， 这 种 开发 方法 需要 时 
间 更 少 ， 也 不 用 考虑 过 多 。 如 果 你 习惯 其 他 的 开发 方法 ， 头 一 次 实践 
可 能 并 不 那么 容易 ， 但 是 经 过 锻炼 ， 用 起 来 就 会 变 容易 。 


这 个 方法 的 精妙 之 处 就 在 于 ， 它 是 根据 实现 的 顺序 来 决策 的 。 总 的 来 


说 ， 在 其 中 的 每 个 阶段 ， 下 一 步 都 只 做 最 容易 的 事情 。 首 先 选 择 加 
法 ， 因 为 这 是 最 简单 的 运算 ， 其 次 选择 减法 ， 因 为 从 逻辑 上 说 ， 它 与 
加 法 只 有 很 小 的 差异 。 第 二 步 也 可 以 选择 乘法 ， 因 为 乘法 无 非 是 把 加 
法 执行 很 多 次 而 已 。 这 时 唯一 不 应 当选 择 的 就 是 除法 ， 因 为 从 加 法 到 
除法 的 步子 距离 太 远 了 ， 步 子 太 大 了 。 而 且 ， 最 后 一 步 从 乘法 到 除法 
是 非常 简单 的 ， 所 以 这 是 一 个 好 的 选择 。 


有 些 时 候 ， 你 甚至 需要 把 其 个 单独 的 功能 拆 分 为 一 系列 小 的 、 简 单 的 
逻辑 步骤 ， 然 后 才 可 以 很 方便 地 实现 。 


显然 ， 这 里 混合 了 两 种 做 法 : 一 种 叫做 “渐进 开发 ”， 另 一 种 叫做 
“渐进 设计 ”。 渐 进 开 发 是 一 种 通过 小 步骤 构建 整个 系统 的 办 法 。 在 上 
面 的 步骤 里 ,“ 实 现 ” 开 头 的 每 一 步 都 是 渐进 开发 过 程 的 一 部 分 。 渐 
进 设计 是 一 种 类 似 的 方法 ， 它 也 通过 一 系列 小 步骤 用 来 创建 和 改进 系 
统 的 设计 。 在 上 面 的 步骤 里 ， 以 “修改 ”或 “设计 ”开头 的 每 一 步 ， 
都 是 渐进 设计 过 程 的 一 部 分 。 


渐进 开发 和 设计 并 不 是 唯一 有 效 的 软件 开发 方法 ， 但 是 它 无 疑 可 以 避 
免 之 前 列 出 的 三 大 误区 。 
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缺陷 与 设计 


很 不 六， 没有 哪个 程序 员 可 以 不 犯错 误 。 不 错 的 程序 员 大 概 每 写 100 
行 代码 就 会 犯 一 个 错误 ， 最 优秀 的 程序 员 ， 在 状态 最 好 的 时 候 ， 每 写 
1000 行 代码 也 会 犯 一 个 错误 。 


也 就 是 说 ， 无 论 程 序 员 的 水 平 是 高 还 是 低 ， 有 一 条 是 不 变 的 : 写 的 代 
码 越 多 ， 引 入 的 缺陷 就 越 多 。 这 样 ， 就 可 以 得 出 “缺陷 概率 定律 ”: 


在 程序 中 新 增 缺 陷 的 可 能 性 与 代码 修改 量 成 正比 。 

一 规则 之 所 以 重要 ， 是 因为 错误 妨碍 了 我 们 帮助 他 人 的 目标 ， 故 而 
应 当 避 免 。 而 且 ， 修 复 缺 陷 也 是 维护 工作 的 一 种 。 所 以 ， 新 增 缺 陷 还 
会 抬 高 维护 成 本 。 
既然 存在 这 条 规则 ， 又 无 法 预测 未 来 ， 我 们 很 快 就 会 发 现 ， 相 比 大 的 
变化 ， 小 的 变化 维护 成 本 更 低 。 小 的 变化 = 更 少 的 缺陷 = 更 少 的 维护 。 
有 时 候 ， 该 规则 也 会 被 非 正 式 地 表述 为 :“ 如 果 不 新 加 代码 ， 也 不 修 
改 代码 ， 就 不 会 产生 新 缺陷 。 
这 条 规则 的 有 趣 之 处 在 于 ， 它 似乎 与 “变化 定律 ” 相 了 矛盾 一 软件 必 
须要 变化 ， 但 是 变 化 又 会 引入 缺陷 。 这 种 矛盾 确实 存在 ， 如 何在 两 者 


间 取 得 平衡 ， 取 决 于 软件 设计 师 的 聪明 才智 。 实 际 上 ， 这 种 矛盾 恰恰 
说 明了 为 什么 需要 设计 ， 而 且 告 诉 我 们 ， 理 想 的 设计 是 怎样 的 : 


最 好 的 设计 ， 就 是 能 过 应 外 界 尽 可 能 多 的 变化 ， 而 软件 自 
身 的 变化 要 尽 可 能 少 。 


这 个 说 法 ， 简 练 融 合 了 如 今 关 于 优秀 的 软件 设计 的 各 项 知识 。 


6.1 如果 这 不 是 问题 …… 


没 错 ， 如 果 不 添加 代码 ， 也 不 修改 代码 ， 就 不 会 引入 新 的 缺陷 ， 这 是 
软件 设计 中 的 一 条 主要 规律 。 不 过 ， 还 有 下 面 这 条 非常 重要 的 规律 与 
之 相关 ， 许 多 软件 设计 师 都 听 过 某 种 形式 的 表述 ， 虽 然 他 们 有 时 候 会 
忘记 : 
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永远 不 要 “修正 ”任何 东西 ， 除 非 它 真 的 有 问题 ， 而 且 有 
证 据 表 明 问 题 确实 存在 。 


在 动手 修正 问题 之 前 ， 获 得 证 据 是 很 重要 的 。 否 则 ， 你 的 辛 将 努力 很 
可 能 解决 不 了 任何 人 的 问题 ,或 者 你 很 可 能 会 “修正 ”根本 没有 问题 
的 代码 。 


如 果 没 脾 得 证 据 就 动手 修正 问题 ， 很 可 能 只 会 添乱 。 修 改 现 有 系 
统 ， 可 能 会 造成 新 的 错误 。 而 且 ， 这 么 做 还 会 浪费 时 间 ， 增 加 程序 的 
复杂 性 ， 却 没有 任何 道理 。 


那么 ， 什 么 是 “证 据 ” 呢 ? 假设 有 五 名 用 户 反馈 : 一 点 击 红色 按钮 ， 
程序 就 月 溃 了 。 好 ， 这 就 是 足够 充分 的 证 据 了 ! 否则 ， 你 可 能 需要 自 
己 去 点 击 红色 按钮 ， 看 看 程序 是 否 崩 溃 。 


但 是 ， 如 有 果 只 有 一 个 用 户 报告 错误 ， 并 不 能 说 明 这 就 是 问题 。 有 时 候 
用 户 不 知道 你 的 程序 已 经 提供 了 某 些 功能 ， 所 以 希望 你 去 重复 实现 它 
们 。 举 例 来 说 ， 你 的 程序 可 以 按照 字母 顺序 来 排序 一 系列 单词 ， 而 用 
户 希 望 你 添加 一 个 功能 ， 能 按 字母 顺序 排序 若干 字母 。 这 个 功能 程序 
里 早 就 有 了 ， 而 且 其 实 比 用 户 想 要 的 还 要 强大 一 一 通常 情况 都 是 这 样 ， 
只 是 用 户 没 弄 清楚 到 底 要 干什么 。 在 这 个 例子 里 ， 因 为 用 户 没 有 发 现 
单词 排序 的 功能 ， 他 可 能 认为 没有 实现 字母 排序 是 个 问题 。 用 户 还 可 
能 给 出 “证 据 *”， 说 明 自 己 无 法 排序 一 系列 字母 。 其 实 ， 问 题 仅 仪 在 
于 ， 他 没有 意识 到 自己 应 该 使 用 单词 排序 的 功能 。 


如 果 你 收 到 很 多 这 样 的 请 求 ， 就 说 明 用 户 很 难 在 你 的 程序 
人 4 。 里 找到 自己 想 要 的 功能 。 这 才 是 真正 要 改进 的 地 方 。 
4 


有 时候 用 户 会 报告 某 个 bug， 但 程序 其 实 是 完全 按照 预期 来 运行 的 。 
果真 如 些 ， 就 应 当 少数 服从 多 数 。 如 果 相 当 多 的 用 户 认为 某 个 行为 是 
bug， 它 就 是 bug; 如 果 只 是 少数 用 户 (比如 一 两 个 ) 认为 它 是 bug， 
那么 它 就 不 算 bug。 


在 这 类 问题 上 ， 最 有 名 的 错误 就 是 所 谓 的 “提前 优化 ”。 也 就 是 说 ， 


有 些 开发 人 员 想 让 速度 尽 可 能 快 ， 所以， 他 们 还 没 弄 清楚 速度 到 底 慢 
不 慢 ， 就 花 时 间 来 优化 程序 。 这 就 好 像 做 慈善 事业 时 ， 一 边 把 食物 送 
给 宣 人 ， 一边 说 “我 们 只 是 希望 帮助 他 人 ”。 这 不 合 逻 辑 ， 对 吧 ? 因 
为 这 样 是 在 解决 根本 不 存在 的 问题 。 


在 你 的 程序 中 ， 真 正 需 要 关注 速度 的 部 分 ， 应 该 局 限于 你 可 以 证 明 
的 、 真 正 让 用 户 体 会 到 有 性 能 问题 的 那些 部 分 。 对 程序 的 其 他 部 分 ， 
最 主要 关心 的 还 是 灵活 和 简洁 ， 而 不 是 速度 。 

要 违背 这 条 规律 有 成 千 上 万 种 办 法 ， 不 过 遵守 它 的 办 法 很 简单 : 在 动 
手 解决 之 前 ， 真 正 拿 到 证 据 ， 证 明 问 题 确实 存在 。 


6.2 ”避免 重复 


在 软件 设计 中 ， 这 或 许 是 最 著名 的 条 例 。 其 他 资料 也 曾 提 过 该 条 例 ， 
鉴于 它 的 重要 性 ， 我 们 在 这 里 重申 ， 


泌 


理想 情况 下 ， 任 何 系统 里 的 任何 信息 ， 都 应 当 只 存在 
一 次 。 
假设 有 个 Password 字段 ， 在 你 的 程序 里 会 出 现在 100 个 用 户 界 面 上 。 
如 果 你 希望 把 它 改 为 Passcode 该 怎么 办 ? 如 果 字 段 名 统一 存储 在 程 
序 革 个 地 方 ， 就 只 需要 修改 一 行 代码 。 但 如 果 每 次 都 是 硬 编码 写 上 
Password， 就 得 修改 100 次 。 


这 个 道理 对 代码 段 也 同样 适用 。 我 们 不 应 该 复制 粘贴 代码 段 ， 相 反 ， 
应 该 使 用 各 种 编程 技巧 来 处 理 ， 让 各 处 的 代码 可 以 “使 用 ”(use)、 
“调用 ”(call)、“ 包 含 ”(include) 已 有 的 其 他 代码 。 


遵守 这 条 规则 的 一 个 强 有 力 的 理由 ， 就 是 缺陷 概率 定律 。 如 果 新 增 功 
能 时 可 以 重用 代码 ， 就 不 需要 写 太 多 代码 ， 引 入 错误 的 可 能 性 也 就 随 
之 减少 了 。 


这 同样 有 益 于 设计 的 灵活 性 。 如 果 我 们 需要 更 改 程序 的 运行 结构 ， 就 
可 以 修改 某 一 部 分 ， 而 不 是 查 遍 整个 程序 ， 在 各 处 修 修补 补 。 
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众多 优秀 设计 都 基于 这 一 规律 。 也 就 是 说 ， 你 能 更 聪明 地 让 代码 “ 上 
的 其 他 代码 ， 把 信息 集中 运用 好 ， 那 么 设计 也 就 更 好 。 在 这 一 
， 你 同样 可 以 真正 用 自己 的 聪明 才智 为 编程 创造 价值 。 


现在 我 们 知道 了 ， 如 果 软 件 一 直 不 变化 ， 就 可 以 彻底 避免 出 现 新 错 
误 。 然 而 ， 软 件 必 定 是 要 变化 的 ， 尤 其 是 需要 增加 新 功能 时 ， 变 化 是 
不 能 避免 的 ， 所 以 “一 直 不 变化 ”并 不 是 彻底 杜绝 错误 的 办 法 。 


第 6 章 讲 过 ， 如 果 和 希望 避免 代码 出 现 新 错误 ， 可 行 的 办 法 之 一 就 是 把 
变化 的 规模 限定 在 小 范围 内 。 不 过 ， 如 果 既 要 做 很 多 修改 ， 又 希望 这 
些 变 化 不 要 引入 错误 ， 还 可 以 用 上 另 一 条 法 则 。 它 不 仅仅 用 来 消除 错 
误 ， 还 可 以 保持 程序 的 可 维护 性 ， 降 低 新 增 功 能 的 难度 ， 让 代码 更 容 
易 理 解 。 这 就 是 简洁 定律 (Law of Simplicity ) : 


软件 任何 一 部 分 的 维护 难度 ， 反 比 于 该 部 分 的 简洁 程度 。 
换 名 话说， 某 一 部 分 的 代码 越 简洁 ， 未 来 进行 变化 的 难度 就 越 低 。 完 
全 消除 维护 的 难度 是 不 可 能 的 ， 但 这 正 是 我 们 要 争取 实现 的 目标 : 如 
果 要 进行 彻底 的 变化 ， 或 者 新 增 大 量 代 码 ， 不 应 该 遇 到 多 少 困 难 。 


你 可 能 注意 到 了 ， 这 条 法 则 并 不 关心 整个 系统 的 简洁 性 ， 只 是 谈 到 了 
各 个 部 分 的 简洁 性 。 这 是 为 什么 呢 ? 


原因 在 于 ， 一 般 的 计算 机 程序 已 经 足够 复杂 了 ， 没 有 人 可 以 一 次 性 全 
面 理解 它 ， 大 家 都 只 能 分 部 份 逐步 了 解 。 虽 然 程序 里 大 都 有 些 庞 大 繁 
杂 的 结构 ， 但 这 不 要 紧 ， 要 紧 的 是 ， 在 我 们 阅读 代码 时 ， 应 该 可 以 理 
解 这 些 庞大 党 杂 的 结构 。 这 些 部 分 越 简洁 ， 就 越 容 易 被 普通 人 理解 。 
这 一 点 非常 重要 ， 尤 其 是 你 把 自己 的 代码 转交 给 其 他 人 ， 或 者 脱离 自 
己 的 代码 儿 个 月 再 重新 上 手 时 ， 更 是 如 此 。 


用 建筑 结构 来 类 比 


假设 要 搭建 30 英 尺 高 的 钢铁 建筑 。 你 可 以 用 很 多 短 撑 杆 ， 也 就 是 小 
零件 来 搭建 ; 也 可 以 先生 产 3 个 巨大 而 复杂 的 构件 ， 再 把 它们 组 合 
起 来 。 

如 果 用 短 撑 杆 来 搭建 ， 零 件 是 很 容易 生产 也 容易 买 到 的 。 假 如 某 个 
零件 坏 掉 了 ， 也 很 容易 找到 备件 来 替换 。 整 个 建筑 过 程 是 简单 的 ， 
维护 也 简单 。 
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如 果 采 用 3 个 大 构件 ， 就 需要 花费 大 量 精力 来 细心 定制 。 因 为 每 个 
构件 都 很 大 ， 因 此 很 难 找到 并 修正 它 的 缺陷 。 而 有 全， 如 果 建 筑 完工 
之 后 发 现 构件 上 有 若干 问 题 ， 你 也 不 能 换 掉 它 一 一 抽 掉 任何 一 个 构 
件 ， 整 个 结构 就 会 倒塌。 所 以 你 只 能 依赖 丑陋 的 补丁 ， 并 且 祈 祷 整 
个 结构 不 会 出 问题 。 


软件 的 情况 与 之 类 似 。 如 果 你 的 代码 写 得 简洁 、 自 洽 ， 那 么 修正 问 
题 、 维 护 系 统 就 很 容易 。 如 果 你 设计 的 是 庞大 繁杂 的 模块 ， 那么 每 
一 部 分 都 需要 花费 大 量 精力 ， 也 很 难 做 到 足够 精致 。 这 样 的 系统 就 
很 难 维护 ， 而 且 必 须 经 常 打 补丁 才 可 以 正常 运行 。 

那么 ， 为 什么 会 有 人 编程 时 要 采用 庞大 演 杂 的 模块 ， 而 不 采用 小 巧 
简洁 的 模块 呢 ? 在 软件 第 一 次 编写 时 ， 采 用 大 模块 表面 上 可 以 节 
省 下 相当 多 的 时 间 。 如 果 使 用 众多 小 模块 ， 就 必须 花 很 多 时 间 来 组 
合 。 如 果 采 用 大 模块 则 不 会 这 样 ， 零 件 很 少 ， 而 且 很 容易 对 接 。 
不 过 ， 由 大 模块 构成 的 系统 ， 质 量 要 差 得 多 ， 而且， 将 来 你 得 花 很 
多 时 间 去 修正 错误 ， 结 果 就 是 维护 的 难度 越 来 越 高 。 相 反 ， 简 单 系 
统 的 维护 难度 会 越 来 越 低 。 长 期 来 看 ， 能 保证 效率 的 恰恰 是 简单 的 
系统 ， 而 不 是 复杂 的 系统 。 


那么 ， 在 真正 编程 的 上 时候， 要 如 何 落实 这 条 法 则 呢 ?” 本 书 的 其 余音 市 
很 大 篇 幅 都 在 讨论 这 个 问题 。 不 过 总 的 来 说 ， 核 心思 想 就 是 要 让 代码 
中 各 个 部 分 都 尽 可 能 简洁 ， 并 且 尽 力 一 直 保 持 这 种 简洁 性 。 


落实 这 条 法 则 的 一 个 好 办 法 ， 就 是 第 5 章 讲解 的 渐进 式 开 发 和 设计 方 
法 。 因 为 每 次 添加 功能 之 前 都 有 个 “重新 设计 ”的 过 程 ， 所 以 系统 能 
持续 简化 。 即 便 不 用 这 种 方法 ， 你 也 可 以 在 增添 新 功能 之 前 ， 花 点 时 
间 去 化 简 任 何 让 你 或 你 的 同事 觉得 不 够 简洁 的 代码 。 

无 论 如 何 ， 你 的 代码 一 般 总 是 归 你 负责 ， 化 简 也 归 你 负责 一 一 你 不 能 
奢望 最 初 的 设计 永远 都 是 最 恰当 的 。 在 新 的 形势 和 需求 面前 ， 你 必须 
不 断 重新 设计 系统 的 各 个 部 分 。 


没 错 ， 这 个 任务 相当 困难 。 不 可 能 任何 时 候 都 有 简单 的 工具 来 写 程 
序 一 一 编程 语言 是 复杂 的 ， 计 算 机 本 身 也 是 复杂 的 。 不 过 ， 我 们 还 是 
应 当 尽力 追求 简洁。 


7.1 简洁 与 软件 设计 方程 式 

虽然 你 可 能 已 经 意识 到 了 ， 这 里 还 是 要 说 ， 简 洁 定律 告诉 我 们 : 目前 
可 行 的 、 能 够 降低 软件 设计 方程 式 中 维护 成 本 的 最 重要 的 事情 ， 就 是 
把 代码 变 简洁 。 我 们 不 必 有 预测 未 来 ， 完 全 可 以 只 审视 自己 的 代码 ， 如 
果 它 足够 复杂 ， 就 立刻 动手 简化 它 。 这 就 是 随时 间 推 移 降低 维护 成 本 
的 办 法 一 一 持续 不 断 地 让 代码 变 得 更 简洁 。 


进行 这 种 简化 有 一 定 的 工作 量 ， 但 是 总 的 来 看 ， 对 简洁 系统 做 修改 总 
是 比 复杂 系统 要 容易 很 多 ， 所 以 ， 现 在 花 一 点 时 间 去 追求 简洁 ， 将 来 
就 可 以 节省 大 量 的 时 间 。 


随 着 系统 维护 成 本 的 降低 ， 各 种 想 做 的 修改 的 可 行 性 也 会 增加 。( 如 
有 果 你 希望 重 温 细 节 ， 请 翻 到 第 4 章 看 看 软件 设计 的 方程 式 。) 化 简 代 
码 可 以 降低 维护 成 本 ， 也 就 增加 了 各 种 可 能 修改 的 可 行 性 。 


A 

7.2 间 洁 是 相对 的 

没 错 ， 我 们 希望 把 代码 变 简 洁 。 不 过 如 何 定义 “简洁 ”， 却 取决 于 你 
的 目标 受众 。 你 觉得 某 个 东西 简洁 ， 你 的 同事 却 可 能 不 这 样 认 为 。 另 
外 ， 你 可 能 觉得 自己 创造 的 某 样 东西 很 “简洁 ”， 因 为 你 了 解 得 非常 
透彻 。 但 是 在 完全 没 接 触 过 的 人 有 眼 里 ， 它 可 能 无 比 复杂 。 


如 果 你 希望 知道 第 一 次 看 你 代码 的 人 有 什么 看 法 ， 不 妨 找 些 从 没 接触 
过 的 代码 来 看 看 。 你 需要 理解 的 不 只 是 那 一 行 行 的 代码 ， 而 是 整个 程 
序 在 干什么 ， 而且 你 还 必须 弄 清 楚 ， 要 做 修改 该 如 何 动 手 。 其 他 人 看 
你 的 代码 的 时 候 ， 就 是 这 种 感觉 。 你 可 能 发 现 了 ， 如 果 阅 读 别人 写 的 
程序 ， 就 算 不 很 复杂 的 代码 也 会 让 人 相当 郁闷 。 


所 以 ， 一 个 不 错 的 做 法 就 是 在 自己 的 代码 注释 中 加 上 类 似 “ 头 一 次 看 
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这 段 代 码 ? 那么 ……” 这 样 的 注释 ， 在 其 中 给 出 一 些 概略 的 解释 ， 帮 
助 其 他 人 理解 。 写 注释 时 应 当 考 虑 到 ， 读 者 完全 不 了 解 这 段 程序 ， 因 
为 如 果 是 你 初次 接触 菜 些 东西 ， 你 灰 怕 也 对 它 一 无 所 知 。 


无 数 的 软件 项 目 在 这 方面 表现 得 一 团 糟 。 翻 开 写 给 开发 者 的 文档 ， 你 
只 能 看 到 大 堆 的 链接 ， 而 没有 任何 头绪 。 如 果 开 发 人 员 已 经 在 这 个 项 
目 上 工作 了 很 长 时 间 ， 事 情 就 非常 简单 ， 因 为 这 张 有 大 量 链接 的 索引 
表 ， 可 以 帮 他 们 迅速 找到 要 看 的 内 容 。 但 是 ， 这 种 文档 对 新 手 来 说 非 
常 复杂。 而 对 工作 了 很 长 时 间 的 开发 人 员 来 说 ， 如 果 在 文档 中 新 增 一 
页 ， 在 上 面 用 简单 醒目 的 按钮 取代 原本 熟悉 的 链接 ， 只 会 把 事情 搞 复 
杂 ， 因 为 他 要 做 的 只 是 在 文档 中 迅速 找到 相应 的 资料 。 


比 起 繁杂 的 文档 ， 更 糟糕 的 情况 就 是 没有 文档 ， 开 发 软件 的 人 认为 其 
他 人 可 以 自己 找 出 问题 ， 或 者 “ 早 就 知道 ”程序 是 怎样 运行 的 。 对 开 
发 人 员 来 说 ， 自 己 写 的 程序 的 原理 是 显而易见 的 ， 但 对 其 他 人 来 说 ， 
这 是 一 个 完全 陌生 的 世界 。 


应 用 场合 (上下文) 也 是 非常 重要 的 。 在 程序 代码 中 ， 先 进 技术 如 果 
使 用 得 当 ， 通 常会 让 代码 简洁 。 但 是 ， 如 果 程 序 的 复杂 内 部 结构 只 有 
通过 某 个 Web 页 才能 看 到 ， 其 他 方式 都 不 可 行 ， 这 就 算 不 上 简洁 了 ， 
即便 对 开发 人 员 来 说 ， 也 不 算 简 洁 。 


有 时 候 ， 某 个 应 用 场合 中 看 来 复杂 的 东西 ， 换 个 应 用 场合 就 会 变 简 
单 。 在 马路 边 的 广告 牌 上 标注 大 量 解 释文 字 是 非常 复杂 的 一 一 过 路 的 
司机 根本 来 不 及 去 看 那么 多 文字 ， 所 以 这 么 做 很 愚蠢 。 但 是 在 程序 使 
用 手册 里 ,给 出 大 量 的 解释 性 文字 就 比 一 句 话 的 概要 描述 简洁 得 多 。 
所 以 ， 本 书 的 每 章 并 不 会 一 句 话 就 完事 。 干 巴巴 地 写 儿 句 话 没有 解 
释 ， 并 不 算 简 洁 。 

考虑 到 不 同 的 视角 和 应 用 场合 ， 追 求 简 洁 是 否 极 其 困难 呢 ? 不 ,绝对 
不 是 。 我 们 做 的 每 一 件 事 都 会 有 目标 受众 ， 每 个 应 用 场合 通常 都 存在 
诸多 限制 。 所 以 ， 追 求 简洁 是 绝对 可 行 的 。 重 要 的 是 要 在 设计 软件 时 
考虑 到 上 述 这 些 因 素 ， 这 样 其 他 人 在 真正 使 用 时 就 会 感到 软件 是 非常 
简单 的 。 


编辑 器 之 战 


完成 某 项 任务 的 最 好 用 的 工具 是 什么 ， 在 软件 开发 的 世界 里 ， 这 是 
个 争论 不 休 的 问题 。 各 人 偏爱 的 文本 编辑 器 不 同 ， 编 程 语言 不 同 ， 
操作 系统 也 不 同 。 在 软件 开发 中 最 著名 的 “战争 ”， 大 概 就 是 两 款 
文本 编辑 器 之 间 的 战争 ， 这 两 款 编辑 器 就 是 Vi 和 Emacs。 每 一 派 的 用 
户 都 宣称 ， 自 己 喜 欢 的 编辑 器 从 根本 上 讲 要 优 于 另 一 款 编辑 器 。 

其 实在 编写 代码 这 件 事 上 ， 基 本 没什么 工具 能 从 根本 上 强 过 另 一 
款 。 实 际 的 情况 是 ， 特 定 的 用 户 觉得 用 某 些 工具 更 容易 解决 手头 的 
具体 问题 。Emacs 用 户 认为 Emacs 是 最 简洁 的 编程 工具 ， 而 Vi 的 用 户 
认为 Vi 是 最 简洁 的 。 从 某 种 程度 上 讲 ， 之 所 以 会 有 这 样 的 局 面 ， 是 
因为 人 的 喜好 是 有 巨大 差别 的 ， 大 家 喜欢 的 工作 方式 不 同 ， 思 维 方 
式 也 不 同 ， 大 家 的 偏好 必然 有 差异 ， 这 并 没有 对 错 可 言 。 但 是 更 深 
入 一 点 来 看 ， 工 具 的 简洁 程度 是 与 每 个 人 的 使 用 熟练 程度 相关 的 。 
任何 人 ， 只 要 使 用 某 款 工 具足 够 长 的 时 间 ， 都 会 更 熟悉 它 ， 从 个 人 
角度 出 发 ， 会 觉得 它 比 其 他 工具 更 简洁 。 如 果 要 求 一 款 新 工具 表现 
得 同样 简单 ， 那 么 这 款 工 具 必 须 简 洁 到 极致 。 显 然 程序 员 用 的 文本 
编辑 器 做 不 到 这 一 点 。 


不 写 程序 的 人 可 能 觉得 两 款 编辑 器 都 太 复杂 了 ， 已 经 无 法 理解 ， 这 
个 例子 再 次 说 明 ， 简 洁 是 相对 的 。 


如 果 工 具 不 适用 于 手头 的 某 个 任务 ， 或 者 在 设计 中 做 了 错 
4 4 。 误 的 选择 (参见 8.2 节 )， 此 工具 就 可 能 带 来 问题 。 如 果 忽 
略 这 些 问 题 ， 工 具 的 相对 简洁 性 就 在 于 ， 在 某 个 具体 的 情 
况 下 ， 程 序 员 可 以 自行 选择 用 起 来 最 舒服 的 工具 。 


7.3 简洁 到 什么 程度 ? 
一 旦 开始 做 某 个 项 目 ， 就 会 遇 到 关于 简洁 的 问题 。 我 们 要 简洁 到 什么 
程度 ? 需要 把 事情 简化 到 什么 程度 ? 它 已 经 足够 简洁 了 吗 ? 


没 错 ， 简 洁 是 相对 的 。 不 过 即便 如 此 ， 还 是 存在 更 简洁 和 更 复杂 的 差 
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别 。 从 用 户 的 角度 出 发 ， 你 的 产品 可 能 很 难 用 ， 也 可 能 很 容易 使 用 ， 
还 可 能 介 于 两 者 之 间 。 同 样 道理 ， 在 其 他 程序 员 看 来 ， 你 的 程序 阅读 
起 来 也 可 能 比较 困难 ， 或 者 比较 简单 。 


那么 ， 要 简洁 到 什么 程度 呢 ? 


要 听 真 话 吗 ? 

你 真 的 想 要 成 功 ? 

简单 到 傻子 也 能 懂 1 

关于 简洁 程度 ， 有 一 点 相当 有 意思 : 在 大 多 数 场合 ， 任 何 普通 人 可 以 


用 到 的 ， 天 才 也 可 以 用 。 所 以 ， 软 件 的 可 能 用 户 的 类 型 ， 或 许 比 设想 
的 要 多 得 多 。 


但 是 大 家 通常 不 理解 ， 怎 么 做 才 算 真正 简单 到 傻子 也 能 懂 。 举 个 例 
子 : 大 商场 里 都 有 一 张 示意 图 标识 方位 。 在 最 清楚 的 示意 图 上 会 有 一 
个 大 红 点 ， 并 在 你 面前 用 醒目 字体 标识 “你 在 这 里 ”。 糟 糕 一 点 的 示 
意图 中 间 会 有 一 个 不 易 发 现 的 小 黄 三 角形 ， 在 示意 图 侧 边 用 文字 说 明 
“小 黄 三 角形 表示 “你 在 这 里 ”"。 这 只 会 让 看 示意 图 的 人 更 困惑 ， 你 
可 能 需要 花 五 六 分 钟 才能 找到 想 去 的 地 方 。 


对 设计 示意 图 的 人 来 说 ， 出 现 这 种 情况 并 不 难 理解 。 既 然 花 了 大 量 的 
时 间 来 设计 ， 那 么 对 他 来 说 ， 这 张 示意 图 显然 足够 重要 ， 他 乐意 花 儿 
分 钟 来 查看 和 学 习 ， 找 到 自己 想 要 的 信息 。 但 是 对 其 他 人 想 的 只 是 看 
看 这 张 图 ， 所 以 根本 不 关心 花 了 多 少时 间 来 设计 。 用 户 只 希望 尽 可 能 
简单 ， 这 样 才能 迅速 上 手 ， 才 能 真正 用 起 来 。 


许多 程序 员 在 这 方面 做 得 尤其 差劲 。 他 们 以 为 别人 都 愿意 花 很 多 时 间 
来 学 习 自 己 写 的 代码 ， 毕 况 这 是 自己 花 很 多 时 间 写 出 来 的 。 这 些 程序 
员 很 重视 自己 的 代码 ， 所 以 对 其 他 人 也 应 当 同 样 重视 。 

没 错 ， 程 序 员 通常 都 是 非常 聪明 的 人 。 但 是 “ 嗅 ， 基 他 程序 员 会 理解 
我 写 的 所 有 代码 ， 没 必要 简化 或 者 注释 ”的 看 法 仍然 是 不 对 的 。 这 个 
问题 与 智商 无 关 ， 而 与 背景 知识 有 关 。 第 一 次 接触 你 代码 的 程序 员 完 


全 没有 任何 背景 知识 ， 他 必须 学 习 。 学 习 的 难度 越 低 ， 找 出 问题 的 速 
度 也 就 越 快 ， 使 用 起 来 也 越 容 易 。 


降低 代码 学 习 难 度 的 方法 有 很 多 : 简洁 的 注释 ， 简 单 的 设计 ， 循 序 渐 


进 的 引导 ， 等 等 。 


不 过 ， 如 果 你 的 代码 没有 做 到 傻子 都 能 看 懂 ， 其 他 人 学 起 来 就 会 遇 到 
困难 。 他 们 会 误解 ， 会 制造 bug， 会 把 事情 搞 得 一 团 粳 。 等 这 一 切 发 
生 的 时 候 ， 他 们 会 找 谁 ? 对 ， 就 是 你 。 这 时 候 你 就 得 花 时 间 回 答 他 们 
的 各 种 问题 。( 咽 ， 听 起 来 挺 讽 刺 的 ， 对 吧 ? ) 


我 们 谁 也 不 希望 被 当成 傻子 来 训导 或 对 待 。 所 以 有 了 时候 我 们 要 搞 出 些 
稍微 复杂 点 的 东西 ， 这 样 才 显得 比 用 户 或 其 他 程序 员 更 聪明 。 我 们 夸 
夸 其 谈 ， 故 意 把 软件 做 复杂 点 ， 让 别人 膜拜 我 们 的 智商 ， 让 他 们 因为 
自己 搞 不 惟 而 感到 思春 。 他 们 可 能 觉得 自己 永远 也 不 会 有 我 们 那么 聪 
明 ， 这 确实 让 我 们 有 种 成 就 感 。 可 是 说 真 的 ， 这 样 做 能 帮助 他 们 吗 ? 


相反 ， 如 果 你 的 产品 或 代码 简单 到 傻子 都 懂 ， 大 家 就 都 可 以 理解 它 。 
这 样 ， 其 他 人 会 感觉 自己 是 聪明 的 ， 也 可 以 完成 自己 希望 完成 的 任 
务 ， 同 时 你 并 没有 增加 多 少 负担 。 其 实 ， 如 有 果 你 把 事情 做 得 简单 而 不 
是 复杂 ， 大 家 甚至 会 更 鲜 幕 你 。 


当然 ， 你 的 家 人 没 必 要 能 读 慌 你 的 代码 。 所 以 ， 简 单 仍然 是 相对 的 ， 
你 的 代码 的 目标 受众 不 是 家 人 ， 而 是 其 他 程序 员 。 但 对 这 些 程序 员 来 
说 ， 你 的 代码 应 该 尽 可 能 简洁 ， 容 易 理 解 。 编 程 过 程 中 完全 可 以 使 用 
所 需 的 各 种 先进 技术 来 达到 这 种 人 简洁， 但 是 代码 本 身 必 须 是 简洁 的 。 


面 对 “ 要 做 到 多 简洁 ”这 种 问题 时 ， 你 可 能 需要 同时 间 自 己 :“ 我 究 
竞 是 要 让 用 户 理解 ， 感 到 快乐 ， 还 是 让 他 们 困惑 ， 感 到 泪 丧 ? ”如 果 
选择 前 者 ， 确 保 成 功 的 复杂 度 就 只 能 是 : 简单 到 傻子 都 能 懂 。 


7.4 保持 一 致 


要 做 到 简单 ， 保 持 一 致 是 很 重要 的 工作 。 如 果 你 在 一 个 地 方 采用 了 基 
种 规则 ， 就 应 当 在 其 他 每 个 地 方 都 遵守 这 种 规则 。 
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如 果 某 个 变量 命名 为 somethingLikeThis， 那 么 所 有 的 变量 
都 应 该 遵守 这 种 规则 (其 他 变量 名 应 该 是 otherVariable、 
anhtoerNameLikeThat 等 )。 如 果 变 量 命名 为 named like this, 
那么 所 有 的 变量 都 应 该 用 小 写 ， 并 且 用 下 划 线 连接 这 些 单词 。 

如 果 代 码 不 能 保持 一 致 ， 程 序 员 理解 和 阅读 起 来 都 要 更 加 困难 。 


还 可 以 举 自然 语言 的 例子 说 明 这 个 道理 ， 看 下 面 两 句 话 : 


。 This is anormal sentence with normal words that everybody can understand. 


。 tHisisanOrmalseNtencewitHnorMalwordsthAtevErybOdycAnunderStaNd. 


两 句 话 的 意思 相同 ， 但 是 第 一 名 更 容易 阅读 ， 因 为 它 符合 大 家 的 书写 习 
惯 。 当 然 ， 第 二 名 也 不 是 看 不 懂 ， 但 是 你 真 的 希望 整 本 书 都 写成 这 个 样 
子 吗 ? 同样 的 道理 ， 如 果 某 个 程序 毫 无 一 致 性 可 言 ， 你 愿意 去 看 吗 ? 


在 编程 时 ， 有 时 候 你 做 什么 并 不 重要 ， 只 要 一 直 保 持 相同 的 方式 去 做 
即 可 。 理 论 上 说 ， 你 当然 可 以 把 代码 写 得 无 比 复杂 ， 但 是 也 要 保持 复 
杂 的 一 致 性 ， 这 样 其 他 人 才 可 以 阅读 。( 当 然 ， 更 好 的 办 法 是 保持 一 
致 并 且 做 到 简单 ， 但 是 如 果 达 不 到 极其 简单 ， 至 少 要 保持 一 致 。) 


在 许多 情况 下 ， 完 全 保持 一 致 可 以 让 编程 更 简单 。 如 果 程 序 中 每 个 对 
象 都 有 一 个 name 字段 ， 你 就 可 以 写 一 小 段 简 单 代码 来 处 理 整个 程序 
中 所 有 对 象 的 name 字段 。 但 是 如 果 在 对 象 A 中 它 叫 做 a name, 在 
对 象 B 中 它 叫 做 name of mine， 你 就 得 为 对 象 A 和 对 象 B 分 别 做 
特殊 处 理 。 


同样 ， 程 序 的 内 部 行为 应 当 保持 一 致 。 如 果 你 已 经 熟悉 了 系统 的 某 个 
部 分 ， 就 应 当 可 以 迅速 熟悉 其 他 部 分 的 代码 ， 因 为 每 部 分 的 风格 都 是 
类 似 的 。 如 果 要 使 用 A 部 分 ， 程 序 员 需 要 调用 三 个 函数 ， 再 写 一 些 代 
码 ， 那么 为 了 使 用 B 部 分 ， 应当 调 用 和 那 三 个 函数 类 似 的 儿 个 函数 ， 
再 写 一 些 代码 。 如 果 在 A 部 分 中 ， 有 个 叫 aump 的 程序 可 以 打印 出 所 
有 内 部 变量 ， 那 么 B 部 分 中 的 aump 函数 应 当 完 成 同样 的 功能 。 千 万 
别 让 程序 员 每 次 遇 到 新 的 部 分 都 重新 学 习 。 


真实 世界 里 或 许 不 存在 这 样 的 一 致 性 ， 但 是 程序 的 世界 由 你 负责 ， 所 
以 必须 保持 程序 的 简单 和 一 致 。 


在 真实 世界 中 也 有 些 一 致 性 的 例子 。 在 亚 训 大 部 分 国家 ， 人 们 用 筷子 
吃饭 。 在 欧美 国家 则 使 用 刀 又 。 虽 然 有 两 类 餐具 ， 但 是 总 的 来 看 ， 在 
某 个 地 区 还 是 相当 一 致 的 。 假 设 每 次 你 去 别人 家 ， 都 必须 学 会 使 用 新 
的 餐具 ，Bob 家 用 的 是 剪刀 ，Mary 家 用 的 是 硬 纸板 ， 这 样 吃饭 就 成 了 
大 问题 ， 不 是 吗 ? 


编程 也 是 这 样 一 一 缺乏 一 致 性 ， 只 会 一 团 糟 。 有 了 一 致 性 ， 世 界 就 很 
简单 。 即 便 你 做 不 到 那么 简单 ， 至 少 也 要 做 到 : 一 旦 你 理解 了 茶 种 复 
杂 性 ， 就 不 必 再 进行 重复 劳动 。 


7.5 可 读 性 


软件 开发 领域 反复 强调 一 点 : 代码 被 阅读 的 次 数 远 多 于 编写 和 修改 的 
次 数 。 所 以 ， 保 证 代码 容易 阅读 很 重要 。 


代码 可 读 性 主要 取决 于 字母 和 符号 之 间 的 空白 排 布 。 


如 果 世 界 是 一 团 读 黑 ， 就 分 不 出 任何 物体 ， 因 为 万 物 都 是 黑色 的 一 
团 。 同 样 道理 ， 如 果 整 个 文件 的 代码 乱 成 一 团 ， 没 有 格式 稳定 、 符 合 
逻辑 的 空白 ， 就 很 难 拆 分 各 个 部 分 。 要 把 各 部 分 拆 分 开 来 ， 就 必须 留 
出 空白 。 


空白 太 多 是 不 必要 的 ， 因 为 这 样 很 难 发 现 事物 之 间 的 联系 。 空 白 太 少 
也 不 必要 ， 因 为 这 样 很 难 分 解 。 代 码 到 底 应 该 留 出 怎样 的 空白 ,没有 
什么 硬性 的 、 直 接 的 规则 ， 唯 一 的 规则 是 ， 代 码 之 间 留 出 的 空白 应 当 
保持 一 致 规范 ， 空 白 应 当 能 有 助 于 读者 理解 代码 的 结构 。 


示例 : 空白 排 布 


下 面 的 代码 很 难看 懂 ， 因 为 空白 太 少 了 ， 几 乎 没有 提供 关于 代码 
结构 的 信息 。 
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X=1+2;y=3+4;2Z=X+y;if (z>y+xX) {print"error";} 


同样 的 代码 ， 这 里 的 空白 又 太 多 了 ， 读 者 很 难 理解 代码 的 结构 。 


x = 工 十 2; 
y= 3 +4; 
z=X 本 y 
EE“ (名 性 y+x) 
{ print "error" ; 
} 


写成 上 面 这 样 ， 甚 至 比 没有 留 出 空白 的 代码 还 要 难看 懂 。 


下 面 这 段 代 码 的 空白 设置 得 比较 合适 : 


> + 2; 
yY=3 + 4; 
z=X+y; 
if (z >y + x) { 


Drint "error,.; 


} 


这 样 读 起 来 就 容易 多 了 ， 也 有 助 于 大 家 理解 程序 员 写 这 段 代码 的 目 
的 。 首 先 给 3 个 变量 赋值 ， 然 后 根据 某 个 条 件 ， 显 示 某 个 错误 。 程 序 


员 通 过 安排 合适 的 空白 ， 把 代码 的 逻辑 结构 清楚 地 向 读者 表达 出 来 。 


如 果 代 码 很 容易 阅读 ， 也 就 容易 修正 。 在 前 面 的 例子 中 ， 如 果 空 白 
留 得 合适 ， 我 们 可 以 很 容易 地 发 现 ， z 永 远 不 可 能 比 y + X 大 ， 因 为 
z 永 远 等 于 y + x。 所 以 ,if (z > y + x) 开头 的 这 段 代 码 其 实 


是 没有 用 的 ， 应 当 删 掉 。 


一 般 来 说 ， 如 果 某 段 代码 有 很 多 bug， 又 难以 阅读 ， 那 么 首先 要 做 


的 是 让 它 更 容易 阅读 。 然 后 ，bug 在 哪里 才能 看 得 更 清楚 。 


7.5.1 命名 
可 读 性 的 另 一 部 分 重要 内 容 是 为 变量 、 函 数 、 类 等 选择 合适 的 名 字 ， 
理想 的 命名 应 该 这 样 : 
名 字 应 当 足 够 长 ， 能 够 完整 表达 其 意义 或 描述 其 功能 ， 但 
不 能 太 长 ， 以 免 影响 阅读 。 
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同时 ， 还 应 当 考 虑 函数 、 变 量 等 的 使 用 频率 。 在 代码 中 使 用 这 些 名 
字 ， 是 否 会 导致 代码 过 长 而 影响 阅读 ?比如 ， 如 果 有 个 函数 只 会 在 某 
一 行 由 你 自己 调用 一 次 (而 且 这 一 行 没有 其 他 代码 )， 它 的 名 字 可 以 
很 长 。 不 过 ， 如 果 某 个 国 数 会 经 常 在 复杂 的 表达 式 中 用 到 ， 大 概 就 该 
取 个 短 一 些 的 名 字 〈 但 还 是 要 足够 长 ， 能 够 描述 它 的 功能 ) 。 


示例 : 命名 


这 段 代 码 的 命名 就 很 糟糕 : 


这 些 名 字 没 有 说 明 变 量 的 用 途 和 函数 的 功能 。 
这 段 代码 与 之 相同 ， 但 命名 很 不 错 : 


quarterly total = sum(january, february, march); 
print (quarterly total); 


还 是 同样 的 代码 ， 但 名 字 太 长 ， 难 以 阅读 : 


quarterly total for company _ in 2011 as of today = 

add all of these together and return the result (january_ 
total amount, 

february total amount, march total amount); 


send to screen and dont wait for user to 
respond (quarterly total for company in 2011 as of today); 


这 些 名 字 占 据 了 太 多 空间 ， 很 难看 明白 。 所 以 从 某 个 角度 来 看 ， 问 
题 又 回 到 了 字母 和 符号 之 间 应 该 怎样 留 出 空白 。 


7.5.2 ”注释 


为 保证 代码 的 可 读 性 ， 好 的 的 注释 也 很 重要 。 但 是 ， 代 码 的 意图 通常 
不 应 该 用 注释 来 说 明 ， 直 接 阅读 代码 就 应 当 能 够 理解 。 如 果 发 现 意图 
不 够 明显 ， 那 么 就 说 明 这 段 代码 还 可 以 变 得 更 简单 。 如 果 你 的 代码 实 
在 不 能 更 简单 ， 才 应 该 写 注释 来 说 明 。 
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注释 的 真实 目的 ， 是 在 理由 不 够 清晰 明显 时 加 以 解释 。 如 果 不 解 释 ， 
其 他 程序 员 在 修改 这 段 代 码 时 可 能 会 很 困惑 ， 如 果 不 明白 这 些 理由 ， 
他 们 可 能 会 删改 其 中 重要 的 部 分 。 


有 些 程序 员 相 信 ， 可 读 性 是 追求 代码 简洁 性 的 全 部 和 终极 目标 ， 如 果 
写 的 代码 很 容易 阅读 ， 你 就 已 经 做 完了 设计 师 要 做 的 一 切 。 但 事实 并 
非 如 此 ， 你 的 代码 可 能 很 容易 阅读 ， 但 系统 仍然 非常 复杂 。 不 过 ， 保 
证 代码 的 可 读 性 是 非常 重要 的 ， 而 且 它 往往 是 通 往 优秀 设计 之 路 上 应 
当 走出 的 第 一 步 。 


7.6 简洁 离 不 开设 计 

不 幸 ， 没 有 人 天 生 就 会 构建 简洁 的 系统 。 如 果 设 计 师 不 倾注 精力 ， 系 
统 就 会 逐渐 变 成 杂乱 庞大 的 怪物 。 

如 果 项 目 没 有 好 的 设计 ， 而 且 持 续 膨胀 ， 最 终 的 局 面 会 复杂 得 让 你 头 
疼 。 有 些 人 可 能 想象 不 出 来 这 种 场景 ， 就 像 有 些 人 预计 不 到 午饭 后 会 
发 生 什么 ， 或 者 有 些 人 缺乏 足够 的 经 验 来 理解 最 终 的 复杂 局 面 。 还 有 
些 企 业 的 文化 是 “ 噢 ， 我 们 只 不 过 缺 几 项 新 功能 ， 做 事 是 应 当 规范 
点 ， 然 而 …… 但 是 …… 可 惜 ……” 不 过 ， 总 有 一 天 你 的 项 目 会 失败 。 
无 论 你 可 以 找到 多 少 理由 ， 失 败 是 避免 不 了 的 。 


有 反 过 来 ， 如 果 你 的 设计 非常 好 ， 一 般 却 难 得 听 到 多 少 称 赞 。 设 计 中 的 
缺陷 是 大 家 都 看 得 到 的 ， 但 逐步 演变 为 良好 设计 的 改进 过 程 ， 却 是 不 
熟悉 代码 的 人 看 不 到 的 。 于 是 ， 设 计 师 就 成 了 一 个 费力 不 讨好 的 工 
作 。 解 决 重大 缺陷 为 你 赢得 很 多 赞誉 ,但 是 避免 缺陷 发 生 …… 咽 ， 没 
有 人 会 注意 到 。 


所 以 ， 让 这 本 书 来 表扬 你 吧 。 关 于 设计 ， 你 有 没有 多 加 思考 ? 有 ? 干 
的 不 错 ! 你 的 用 户 和 同事 会 感觉 到 好 处 一 一 运行 流畅 的 软件 ， 按 时 的 
发 布 ， 条理 分 明 、 容 易 理 解 的 代码 。 你 对 自己 的 工作 有 足够 的 信心 ， 
完工 之 后 充满 了 成 就 感 。 其 他 程序 员 知 道 要 花 多 少 精 力 才 让 一 切 有 条 
理 吗 ?可 能 不 知道 。 但 是 ， 这 不 要 紧 。 除 去 你 周围 人 的 称赞 ， 还 有 其 
他 的 奖励 。 


只 有 在 个 别 情况 下 ， 你 的 工作 才 会 赢得 其 他 人 的 称赞 。 但 是 别 绝望 ， 
最 后 总 会 有 人 注意 到 的 。 在 这 之 前 ， 你 应 当 享受 有 效 、 正 确 的 设计 所 
带 来 的 各 种 积极 结果 。 


凤 sa， 


如 果 把 本 书 中 提 到 的 设计 原则 应 用 到 手头 的 项 目 中 ， 经 验 
不 多 的 程序 员 或 同事 可 能 要 花 很 长 的 时 间 才 能 理解 ， 他 们 
为 什么 同样 需要 追求 优秀 的 设计 。 请 他 们 来 读 这 本 书 可 能 


会 帮 上 点 忙 ， 如 果 他 们 不 能 或 不 愿意 ， 应 当 


寺 续 引导 他 们 


(如 果实 在 不 得 已 ， 就 强迫 他 们 ) 追求 优秀 的 设计 ， 他 们 会 


在 (最多) 几 年 后 认识 到 ， 优 秀 的 设计 能 带 来 怎样 的 好 处 。 
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复 来 性 


身 为 职业 程序 员 ， 你 很 可 能 听 说 过 (或 者 经 历 过 ) 常见 的 程序 开发 置 
梦 :“ 五 年 前 项 目 启 动 时 ， 这 项 技术 还 是 很 先进 的 ， 可 是 现在 过 时 了 。 
因为 技术 已 经 被 淘汰 ， 事 情 越 变 越 复杂 ， 所 以 项 目 完 成 的 希望 越 来 越 
游荡 。 但 是 如 果 推 倒 重 来 ， 可 能 还 要 等 上 五 年 。” 


还 有 一 个 情况 也 很 常见 :“ 我 们 的 开发 速度 不 够 快 ， 跟 不 上 现在 用 户 
的 需求 。” “我们 正在 开发 ，X 公司 就 以 更 快 的 速度 完成 了 比 我 们 更 好 
的 产品 。 


我 们 现在 知道 ， 这 些 问 题 的 根源 都 在 复杂 性 。 开 始 的 时 候 项 目 是 简单 
的 ， 只 要 一 个 月 就 能 完成 ， 然 后 复杂 性 增加 了 ， 于 是 需要 三 个 月 时 
间 ， 再 然后 ， 每 个 部 分 都 更 加 复杂 ， 所 以 项 目 需要 九 个 月 才能 完成 。 


复杂 性 是 会 全 加 的 ， 而 且 不 是 简单 的 线性 全 加 。 也 就 是 说 ， 下 述 假设 
是 不 成 立 的 : 之 前 有 10 项 功能 要 开发 ， 因 此 再 加 1 项 只 会 增添 10% 
的 工作 量 。 因 为 新 增 的 功能 需要 与 已 有 的 10 项 功能 相 协调 ， 所 以 如 
果 开 发 新 功能 需要 10 小时， 可 能 还 要 花 10 小 时 才能 保证 已 有 的 10 
项 功能 与 新 功能 正常 交互 。 原 有 功能 越 多 ， 新 增 功能 的 成 本 就 越 高 。 
优秀 的 设计 可 以 尽量 避免 此 类 问题 ， 但 是 每 项 新 功能 仍然 会 有 单独 的 
成 本 。 

有 些 项 目 从 一 启动 就 设 定 了 繁多 的 需求 ， 所 以 永远 无 法 发 布 第 一 版 。 
如 果 遇 到 这 种 情况 ， 就 应 当 删 减 功能 。 初 次 发 布 不 应 当 设 定 过 高 的 目 
标 ， 而 应 当先 让 程序 跑 起 来 ， 再 持续 改进 。 


除了 新 增 功能 ， 其 他 一 些 做 法 也 会 增加 复杂 性 ， 以 下 列 出 了 最 常见 的 
做 法 。 


1. 扩展 软件 的 用 途 

一 般 情 况 下 ， 应 当 绝对 禁止 这 样 做 。 市 场 部 可 能 巴 望 着 某 款 软件 既 能 
够 计算 个 税 ， 又 可 以 充当 菜谱 ， 这 样 的 需求 ， 你 必须 尽 全 力 抵 制 。 软 
件 应 当 坚 守 已 经 确定 的 用 途 ， 只 要 妥善 完成 这 些 目标 ， 你 就 会 获得 成 
功 〈 前 提 是 该 软件 能 帮 有 到 用 户 ， 切 实 满足 其 需求 ) 。 


2. 新 增 程序 员 

没 错 ， 往 团队 里 增加 新 人 并 不 会 让 事情 变 简 单 ， 相 反 会 更 复杂 。Fred 
Brooks 的 名 作 《 人 月 神话 》 说 的 就 是 这 个 道理 。 如 果 已 经 有 了 10 个 
开发 人 员 ， 再 增加 1 个人， 就 意味 着 需要 为 他 设 定 合适 的 岗位 ， 花 时 
间 让 之 前 的 10 个 人 适应 新 人 ， 花 时 间 让 新 人 学 会 与 那 10 个 人 沟通 ， 
如 此 等 等 。 相 比 众 多 平庸 的 开发 人 员 ， 少 量 精干 的 开发 人 员 更 容易 获 
得 成 功 。 


3. 做 无 谓 的 改变 

每 做 一 点 改变 ， 都 会 增加 复杂 性 。 无 论 是 需求 变化 、 设 计 变化 ， 或 是 
只 修改 某 段 代码 ， 都 有 可 能 增加 新 的 bug， 另 外 别 忘 了 算 上 决定 如 何 
变化 所 需 的 时 间 ， 实 现 它 所 需 的 时 间 ， 验 证 它 是 否 影响 到 原 有 系统 所 
需 的 时 间 ， 记 录 它 的 时 间 ， 测 试 它 的 时 间 。 每 做 一 点 新 变化 ， 整 体 复 
杂 性 就 会 增加 一 点 ， 所 以 变化 越 多 ， 每 个 变化 要 花 的 时 间 就 越 长 。 做 
出 某 些 变 化 是 重要 的 ， 但 是 应 当 谨 慎 决 策 ， 而 不 是 一 拍 脑 瓜 就 定 了 。 


4. 困 于 糟糕 的 技术 

一 般 来 说 ,“ 困 于 糟糕 的 技术 ” 指 的 是 你 之 前 决定 了 采用 某 种 技术 ， 
因为 极度 依赖 它 ， 长 期 无 法 摆脱 。 这 里 说 的 “糟糕 "， 意 思 是 你 深 陷 
其 中 (未 来 无 法 简单 地 切换 到 其 他 技术 )， 不 能 灵活 地 适应 未 来 的 需 
求 ， 或 是 达 不 到 设计 简洁 软件 所 需 的 质量 标准 。 


5. 理解 错误 

程序 员 不 理解 自己 的 工作 ， 就 容易 设计 出 复杂 的 系统 。 这 可 能 是 恶性 
循环 : 理解 错误 导致 复杂 性 ， 复 杂 性 又 进一步 加 剧 理解 错误 ， 如 此 往 
复 。 提 升 设计 水 平 的 最 主要 办 法 是 ， 确 保 自己 完全 理解 所 用 的 系统 和 
工具 。 你 对 它们 的 理解 越 到 位 ， 对 软件 开发 的 一 般 规 律 了 解 越 多 ， 你 
的 设计 就 越 简洁。 


6. 糟糕 的 设计 或 不 做 设计 
一 般 来 说 ， 它 指 的 是 “没有 为 变化 做 计划 ”。 万 物 都 是 会 变化 的 ， 项 目 


增长 时 ， 设 计 仍 然 要 维持 简单 。 你 必须 一 开始 就 做 好 设计 ， 而 且 在 系 
统 膨 胀 时 不 断 进 行 优秀 的 设计 ， 否 则 ， 复 杂 性 就 会 迅速 增长 ， 因 为 如 
果 设 计 得 不 好 ， 每 项 功能 都 会 让 代码 加 倍 复杂 ， 而 不 是 只 复杂 一 点 点 。 


7. 重新 发 明 轮 子 

如 果 有 相当 不 错 的 现成 协议 ， 还 要 自己 发 明 协 议 ， 那 么 仅仅 为 了 把 软 
件 跑 起 来 ， 这 些 协议 也 会 花 去 你 大 量 的 时 间 。 决 不 要 什么 都 靠 自力 更 
生 ， 去 自己 开发 什么 Web 服务 器 、 协 议 或 者 重要 的 类 库 ， 除 非 它 们 是 
你 的 最 终 产品 。 只 有 在 满足 以 下 任何 一 个 条 件 的 前 提 下 ， 重 新 发 明 轮 
子 才 有 价值 : 


(1) 你 需要 的 东西 不 存在 ， 

(2) 现 有 的 各 种 “轮子 ”都 很 粳 糕 ， 会 把 你 困 住 ; 

(3) 现 有 的 “轮子 ”根本 无 法 满足 你 的 需求 ， 

(4) 现 有 的 “轮子 ”缺乏 良好 的 维护 ， 而 你 也 不 能 接 过 维护 的 任务 ( 比 
如 ， 你 没有 源 代码 )。 


这 些 因素 都 会 逐渐 影响 你 的 项 目 ， 但 不 会 在 短 时 间 凸 显 。 它 们 大 多 数 
会 造成 长 期 的 负面 影响 ， 甚 至 一 两 年 内 都 觉察 不 出 来 ， 所 以 如 果 有 人 
指出 这 些 问题 ,通常 大 家 也 不 觉得 有 什么 坏处 。 即 便 你 走 上 这 条 路 ， 
重新 发 明 的 轮子 可 能 看 来 也 没有 问题 。 但 是 随 着 时 间 的 推移 ， 尤 其 是 
这 些 轮子 堆积 起 来 后 ， 复 杂 性 会 越发 明显 ， 不 断 累加 ， 最 终 你 就 成 了 
那个 广为人知 的 故事 的 受害 者 ， 产 品 永远 也 发 布 不 了 。 


8.1 复杂 性 与 软件 的 用 途 


你 正 开发 的 任何 系统 ， 其 基本 用 途 应 当 相当 简单 。 这 样 开发 出 来 的 系 
统 ， 既 满足 实际 需求 ， 整 体 来 说 也 是 简单 的 。 但 是 ， 如 果 你 给 系统 添 
加 新 功能 去 满足 其 他 目标 ， 事情 就 立刻 变 复杂 了 。 举 例 来 说 ， 文 字 处 
理 软 件 的 基本 功能 就 是 帮助 用 户 写 作文 档 。 如 果 突 然 要 求 它 能 够 阅读 
邮件 ， 最终 就 会 得 到 的 非常 苑 唐 复杂 的 玩意 。 你 能 设想 它 的 用 户 界面 
吗 ? 各 个 按钮 都 要 放 在 哪里 ? 我 们 都 知道 ， 这 不 是 文字 处 理 软件 本 来 


复杂 性 | 81 


的 用 途 。 这 么 做 ， 其 至 都 不 是 在 扩展 软件 的 用 途 ， 而 是 增添 与 目的 无 
关 的 功能 。 


同样 重要 的 是 要 思考 用 户 的 需求 。 用 户 之 所 以 要 使 用 软件 ， 总 是 有 自 
己 的 需求 。 理 想 情 况 下 ， 软 件 的 用 途 应 当 相当 接近 用 户 的 需求 。 举 个 
例子 ， 假 设 用 户 要 的 是 计算 自己 的 报税 数据 ， 那 么 他 所 需要 软件 的 用 
途 就 是 帮助 用 户 计算 个 人 的 报税 数据 。 


软件 的 用 途 如 果 不 符合 用 户 的 需求 ， 就 很 可 能 让 用 户 的 生活 更 复杂 。 
如 果 用 户 和 希望 的 是 阅读 邮件 ， 但 是 程序 的 主要 目的 是 向 用 户 展示 广 
告 ， 这 两 者 就 不 协调 。 


想 要 看 到 用 户 勃 然 大 的 吗 ? 只 需要 刻意 阻 得 他 们 达到 目的 即 可 。 在 用 
户 要 做 正事 的 时 候 ， 当 面 弹出 几 个 窗口 ， 或 者 新 增 一 扒 功 能 ， 让 他 无 
法 分 辨 ， 或 者 显示 一 大 堆 他 完全 不 认识 的 图 标 。 让 用 户 勃 然 大 奴 方 法 
多 多 ， 都 无 非 是 干扰 用 户 的 需求 ， 背 离 软件 自身 的 基本 用 途 。 


有 时 候 ， 营 销 人 员 或 者 经 理会 给 软件 设 定 一 些 目标 ,但 是 这 些 目 标 其 
实 并 不 符合 程序 的 基本 用 途 ， 比 如 “要 好 玩 一 些 *" “设计 要 更 有 冲击 
感 "、“ 要 受 新 媒体 欢迎 ”,“ 要 使 用 最 新 的 技术 ”等 等 。 这 些 人 可 能 是 
公司 里 的 重要 人 物 ， 但 他 们 不 是 那些 决定 程序 应 当做 什么 的 人 。 身 为 
软件 设计 师 或 是 技术 经 理 ， 你 的 职责 是 保证 软件 的 基本 用 途 ， 防 止 它 
偏离 正轨 ， 这 个 责任 其 他 人 谁 也 担 不 起 。 有 了 时候， 你 可 能 需要 为 此 据 
理 力争 ， 但 从 长 期 来 看 ， 这 肯定 是 值得 的 。 


而 且 ， 这 不 是 要 你 为 此 去 承担 营销 失利 的 责任 。 已 经 有 许多 产品 因为 
执着 于 单一 用 途 而 获得 了 巨大 的 成 功 。 肥 皂 的 用 途 是 清洁 ， 食 盐 的 用 
途 是 调味 ， 灯 泡 的 用 途 是 照明 ,许多 公司 已 经 依靠 这 些 产 品 生 存 了 儿 
十 年 。 有 效 的 营销 与 复杂 的 产品 没有 必然 联系 ， 要 做 好 营销 ， 你 需要 
懂得 营销 的 知识 和 技巧 ， 但 是 这 个 领域 与 软件 设计 完全 不 同 。 

这 是 千 真 万 确 的 ， 没 有 必要 玩 太 多 花样 ， 做 太 复 杂 ， 党 试用 单个 软件 
瞬间 完成 500 个 任务 。 最 受用 户 喜 欢 的 软件 是 专注 而 简洁 的 ， 并 且 始 
终 执着 于 基本 用 途 。 


8.2 ” 糖 糕 的 技术 


出 现 复 杂 性 的 另 一 个 常见 原因 就 是 ， 系 统 里 选择 了 错误 的 技术 ， 尤 其 
是 最 终 发 现 并 不 能 很 好 适应 未 来 需求 的 技术 。 但 是 既然 无 法 预测 未 
来 ， 现 在 就 决定 要 选择 什么 技术 并 不 简单 。 好 在 ， 开 始 使 用 之 前 ， 你 
可 以 通过 三 个 因素 来 判断 技术 是 否 “糟糕 : 生存 潜力 、 互 通 性 、 对 
品质 的 重视 。 


8.2.1 生存 潜力 

某 种 技术 的 生存 法力， 就 是 它 持续 获得 维护 的 可 能 性 。 如 果 某 种 类 库 
或 依赖 项 已 经 过 时 ,没有 人 维护 ， 你 却 死 守 着 它们 ， 就 有 麻烦 在 等 着 
愉 了 。 


要 了 解 某 款 软件 的 生存 潜力 ， 可 以 查阅 其 最 近 的 发 布 记 录 。 开 发 者 是 
否 频 繁 地 发 布 真正 解决 了 客户 问题 的 新 版 本 ? 另外， 开发 者 对 bug 报 
告 的 响应 有 多 积极 ?他 们 是 否 有 活跃 的 邮件 列表 或 支持 团队 ?是 否 有 
足够 的 人 在 线 谈论 这 项 技术 ?如 果菜 项 技术 现在 有 足够 的 活力 ， 你 可 
以 相当 肯定 它 不 会 很 快 灭亡 。 

另外 还 得 看 看 ， 是 否 只 有 一 家 供应 商 在 推进 这 项 技术 ， 以 及 它 是 否 被 不 
同 开发 人 员 开 发 的 各 种 程序 所 接受 和 使 用 。 如 果 只 有 一 家 供应 商 来 推动 
和 改造 ， 那 么 万 一 供应 商 甩 手 不 管 或 者 决定 停止 维护 ， 你 就 麻烦 了 。 


接受 广泛 程度 
这 个 说 法 听 起 来 的 意思 似乎 是 ， 应 当 从 符合 需求 的 技术 中 选择 接 
受 最 广泛 的 。 从 某 种 程度 上 说 这 是 真 的 ， 被 接受 的 技术 一 般 部 是 有 相 
当 大 的 生存 潜力 。 不 过 ， 你 还 是 必须 辨别 ， 到 底 是 经 过 考验 才 被 大 家 
接受 ， 还 是 仅仅 是 因为 菜 种 奴 断 而 被 接受 。 
在 写作 本 书 时 ，C 是 经 过 验证 的 广泛 接受 的 语言 。 在 各 种 公司 ， 
有 各 种 人 ， 为 各 种 不 同 的 目的 使 用 C 语 言 。 关 于 C 语 言 有 许多 国际 标 
准 ， 每 项 标准 又 有 众多 的 实现 ， 和 包含 许多 广泛 使 用 的 编译 器 。 
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不 过 ， 有 些 技术 之 所 以 被 广泛 接受 ， 是 因为 用 户 别 无 选择 !:。 假 
设 X 公 司 设计 了 自己 的 编程 语言 ， 然 后 又 设计 了 一 种 广泛 接受 的 设 
备 ， 这 种 设备 只 接受 这 种 语言 编写 的 程序 。 这 就 是 上 面 提 到 的 “单一 
供应 商 ” 情 况 ， 语 言 看 起 来 被 广泛 接受 ， 但 生存 潜力 其 实 很 小 ， 除 非 
它 能 被 整个 软件 行业 广泛 接受 。 


8.2.2 ”互通 性 


所 谓 互通 性 ， 指 的 是 如 果 需 要 ， 从 一 种 技术 切换 到 另 一 种 技术 有 多 
难 。 要 了 解 技术 的 互通 性 ， 就 得 问 问 自己 :“ 我 们 能 不 能 以 某 种 标准 
方式 来 交互 ， 这 样 就 更 容易 切换 到 遵循 同样 标准 的 其 他 系统 ?” 


举例 来 说 ， 有 些 国 际 标 准 规定 了 程序 应 当 如 何 与 数据 库 系 统 交 互 。 有 
些 数据 库 对 这 种 标准 的 支持 很 好 ， 如 果 你 选择 这 些 支 持 良 好 的 数据 
库 ， 将 来 程序 只 需要 做 很 小 的 改动 ， 就 很 容易 切换 到 其 他 数据 库 。 
不 过 ， 也 有 些 数据 库 对 标准 的 支持 并 不 好 。 如 果 你 希望 切换 到 这 种 支 
持 糟 糕 的 数据 库 ， 就 得 重 写 自 己 的 程序 。 所 以 ， 如 果 选 择 非 标准 系 
统 ， 就 会 身 陷 罗网 ， 难 以 切换 。 


8.2.3 ”对 品质 的 重视 


这 是 一 种 更 主观 的 衡量 ， 其 思想 是 考察 最 近 的 发 布 中 ， 产 品 是 否 更 加 
完善 了 。 如 果 你 可 以 看 到 源 代码 ， 检 查 一 下 开发 人 员 是 否 进行 了 重 
构 ， 清 理 了 代码 。 产 品 是 更 容易 使 用 了 ， 还 是 更 难 用 了 ? 维护 它 的 人 
真 的 在 乎 产品 的 质量 吗 ? 最 近 是 否 多 次 出 现 似 乎 由 糟糕 的 编程 所 引发 
的 严重 安全 问题 ? 


注 1: 开发 人 员 可 能 对 自己 所 用 的 技术 有 独特 的 热情 。 为 了 避免 触犯 这 类 用 户 ， 我 们 还 是 
不 提 具 体 的 技术 为 佳 。 


8.2.4 其 他 原因 


在 选择 技术 时 ， 还 有 其 他 因素 需要 考虑 ， 主 要 是 它 是 否 简洁 ， 是 否 符 
合 软 件 的 基本 用 途 。 在 衡量 完 所 有 实际 因素 之 后 ， 也 可 以 考虑 个 人 喜 
好 。 有 些 人 更 看 重 某 种 编程 语言 在 某 些 方面 的 优势 。 有 时 候 ， 这 也 是 
选择 技术 的 有 效 理由 : 如 果 两 种 技术 在 其 他 方面 都 差不多 ， 就 会 选择 
更 喜欢 的 那 种 。 毕 竞 ， 最终 真 正 使 用 它 的 人 是 你 ， 你 的 意见 很 重要 | 
上 面 这 些 指引 只 负责 帮 有 你 排除 掉 精 糕 的 选择 ， 剩 下 的 则 取决 于 你 自己 
的 研究 、 需 求 、 计 划 。 


8.3 复杂 性 及 错误 的 解决 方案 
通常 ， 如 果 某 件 事情 变 得 非常 复杂 ， 也 就 意味 绝 不 是 表面 的 复杂 那么 
简单 ， 而 是 设计 出 了 问题 。 


假如 汽车 的 轮子 是 方形 的 ， 它 当然 开 不 快 。 这 时 候 ， 改 造 发 动机 并 不 
能 解决 问题 ， 你 需要 重新 设计 汽车 ， 换 上 圆 形 的 轮子 。 


一 且 程 序 里 出 现 了 “无 法 解决 的 复杂 性 ”， 就 说 明 设 计 中 有 些 深 层次 
的 基本 错误 。 如 果 问 题 在 这 个 层面 上 无 法 解决 ， 应 当 回 过 头 去 看 看 产 
生 问 题 的 真正 原因 是 什么 。 


其 实 ， 程 序 员 经 常 这 么 做 。 你 可 能 会 说 : 这 代码 太 垃 圾 了， 要 添加 新 
功能 真 够 麻烦 的 。 那 么 ， 深 层次 的 基本 问题 就 是 代码 大 混乱。 所 以 ， 
你 应 该 整理 这 些 代码 ， 让 它们 变 简 洁 ， 你 就 会 发 现 增加 新 功能 也 会 变 
简单 。 


真正 要 解决 的 问题 是 什么 ? 


如 果 有 人 问 你 :“ 怎 么 让 小 马 飞 上 月 球 ? ”你 要 反问 的 就 是 :“ 要 解决 
的 究竟 是 什么 问题 ? ”你 可 能 发 现 ， 这 个 人 真正 需要 的 其 实 是 收集 一 
些 灰色 的 岩石 。 为 什么 要 去 月 球 ， 还 必须 弄 一 匹 小 马 ， 只 有 他 自己 知 
道 。 很 多 人 真 的 会 弄 混 淆 这 类 问题 ， 所 以 应 当 问 问 他 们 ， 究 况 要 解决 
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什么 问题 ， 然 后 简单 的 办 法 就 会 自己 冒 出 来 。 在 上 面 的 例子 里 , 一旦 
彻底 弄 清 楚 了 问题 ， 解 决 方案 就 很 简单 直接 : 去 室外 找 些 灰色 的 岩石 
就 够 了 ， 根 本 用 不 着 小 马 。 


所 以 ， 如 果 事 情 变 复杂 ， 不 妨 回 过 头 去 看 看 真正 要 解决 的 是 什么 问 
题 。 你 可 以 退 上 一 大 步 ， 也 可 以 质疑 任何 问题 。 有 可 能 为 了 得 到 4， 
你 想到 的 是 2+2， 但 没 想到 1+3 也 可 以 ， 或 者 干脆 不 要 加 法 ， 直 接 取 
得 4 也 行 。 真 正 的 问题 是 “我 如 何 得 到 4 这 个 数字 ”， 任 何 可 行 的 方 
案 都 是 可 以 接受 的 。 所 以 你 真正 要 做 的 就 是 ， 找 出 自己 所 处 的 环境 中 
最 好 的 办 法 。 


要 做 到 这 一 点 ， 不 应 当 依靠 猜测 ， 而 必须 亲眼 去 看 要 解决 的 问题 。 确 
认 你 真正 理解 了 问题 的 方方面面 ， 找 到 最 简单 的 解决 办 法 。 不 要 问 
“用 现 有 代码 怎么 解决 这 个 问题 ”， 或 者 “Anne 教授 在 程序 里 是 怎么 
解决 这 个 问题 的 "， 而 是 问 问 你 自己 :“ 通 常情 况 下 ， 在 最 完美 的 方案 
里 ,这 类 问题 要 如 何 解 决 ? ”这 样 ， 你 大 概 就 可 以 看 出 代码 应 该 如 何 
重 写 了 。 然 后 ， 就 可 以 着 手 解决 问题 。 


再 然后 ， 问 题 就 不 复 存在 了 。 


8.4 复杂 问题 


有 时 候 你 受命 去 解决 一 些 本 身 就 非常 复杂 的 问题 ， 比 如 编写 拼写 检查 
或 国际 象棋 的 程序 。 问 题 复杂 ， 解 法 不 一 定 会 复杂 ; 相反 ， 在 处 理 此 
类 问题 时 ， 你 必须 更 努力 地 追求 代码 的 简洁 。 
如 果 你 在 解决 复杂 问题 时 遇 到 了 麻烦 ， 那 么 用 简单 易 懂 的 文字 把 它 写 
在 纸 上 ， 或 者 画 出 来 。 有 些 最 优秀 的 程序 设计 就 是 在 纸 上 完 成 的 ， 真 
的 。 把 它 输入 到 计算 机 里 只 是 次 要 的 细 市 。 


大 多 数 麻 烦 的 设计 问题 ， 都 可 以 用 在 纸 上 和 画图 或 写 出 来 的 
办 法 找到 答案 。 


8.5 应 对 复杂 性 


身 为 程序 员 ， 你 必然 要 面 对 复 杂 性 。 其 他 程序 员 会 写 复杂 的 程序 ， 你 
必须 去 修正 。 硬 件 设计 师 和 语言 设计 师 会 让 你 的 生活 更 麻烦 。 


如 果 系 统 中 某 个 部 分 太 过 复杂 ， 有 个 好 办 法 来 解决 ， 把 它 分 解 成 儿 个 
独立 的 小 部 分 ， 逐 步 重 新 设计 。 每 次 修改 都 应 该 足够 小 ， 这 样 可 以 放 
心动 手 ， 不 会 让 事情 更 复杂 。 不 过 这 个 过 程 中 最 大 的 危险 是 ， 新 做 的 
修改 有 可 能 会 引入 更 多 的 复杂 性 。 许 多 重 设计 或 重 写 的 工作 之 所 以 最 
终 失 败 ， 就 是 因为 它们 引入 了 更 多 的 复杂 性 ， 结 果 最 后 和 原 有 系统 同 
样 复杂 。 


每 个 步骤 都 应 该 足够 小 ， 比 如 给 某 个 变量 取 个 更 好 的 名 字 ， 或 是 给 难 
看 懂 的 代码 增加 一 些 注释 。 更 常见 的 做 法 是 在 每 个 步骤 中 都 把 一 个 复 
杂 的 部 分 拆 分 成 若干 个 简单 的 部 分 。 


如 果 所 有 的 代码 都 包含 在 一 个 巨大 的 文件 里 ， 改 进 的 第 一 步 就 是 把 某 
个 部 分 保存 到 单独 的 文件 里 。 之 后 改进 这 个 小 部 分 的 设计 ， 然 后 把 另 
一 个 部 分 保存 到 新 的 文件 ， 再 改进 这 个 部 分 的 设计 。 如 此 重复 下 去 ， 
最 终 得 到 的 就 是 可 靠 的 、 可 理解 的 、 可 维护 的 系统 。 


如 果 系 统 非 常 复杂 ， 这 么 做 的 工作 量 可 能 相当 大 ， 所 以 必须 有 耐心 。 
你 必须 首先 做 好 设计 ， 改 进 之 后 的 系统 要 比 现在 的 简单 一 一 即便 只 是 
简单 一 点 点 。 然 后 ， 朝 着 这 个 目标 一 步 步 地 前 进 。 得 到 了 这 个 简单 的 
系统 之 后 ， 就 设计 下 一 个 更 简单 的 系统 ， 再 朝 那个 目标 前 进 。 不 必 设 
计 “ 完 美 ” 的 系统 ， 因 为 它 不 存在 。 你 只 需要 持续 不 懈 地 追求 比 现 有 
系统 更 好 的 系统 ， 最 终 就 会 得 到 相当 容易 管理 的 简洁 系统 。 


不 过 ， 还 有 一 点 也 很 重要 ， 你 不 能 专门 花 很 长 的 时 间 来 重新 设计 ， 停 
止 开发 新 功能 。 变 化 定律 告诉 我 们 ， 程 序 所 处 的 环境 是 持续 变化 的 ， 
所 以 程序 的 功能 也 必须 去 适应 这 些 变化 。 如 果 在 相当 长 的 时 间 里 ， 你 
都 不 能 从 用 户 角 度 出 发 来 调适 和 改进 ， 就 可 能 失去 自己 的 用 户 ， 把 项 
目 乔 死 。 
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好 在 平衡 开发 新 功能 和 应 对 复杂 性 这 两 项 任务 的 方法 有 很 多 。 最 好 的 
一 个 办 法 就 是 ， 重 新 设计 时 只 考虑 让 新 功能 更 容易 实现 ， 然 后 实现 这 
个 功能 。 这 样 ， 你 就 可 以 在 重新 设计 和 开发 新 功能 之 间 定 期 切换 。 它 
同样 有 助 于 保证 新 设计 能 够 适应 需求 ， 因 为 设计 时 会 考虑 到 实际 的 应 
用 。 系 统 的 复杂 性 也 会 逐渐 下 降 ， 而 且 你 一 直 都 跟 得 上 用 户 的 需求 。 
你 甚至 可 以 这 样 来 处 理 bug: 如 果 发 现 修改 设计 之 后 ， 某 些 bug 更 容 
易 人 和 修复， 那么 先 重新 设计 代码 再 修复 bug。 


为 新 增 功能 重新 设计 


有 个 叫 Bugzilla 的 项 目 ， 它 的 所 有 数据 都 存储 在 数据 库 中 。Bugzilla 
只 支持 用 某 种 特定 的 数据 库 来 存储 ， 这 里 我 们 叫 它 OldDB。 有 些 新 
客户 要 求 使 用 别 的 数据 库 来 存储 数据 ， 我 们 叫 它 NewDB。 客 户 的 理 
由 很 充分 : 相 比 OlIdDB， 他 们 更 熟悉 NewDB， 而 且 他 们 公司 已 经 在 
用 NewDB 了 。 但 是 ， 原 有 的 客户 希望 继续 使 用 OldDB。 


所 以 ，Bugzilla 必 须 支 持 多 种 数据 库 。 这 需要 大 量 修改 代码 ， 因 为 
Bugzilla 没 有 统一 存 取 数 据 库 的 接口 。 相 反 ， 代 码 里 散落 着 很 多 自 定 
义 的 数据 库 处 理 指 令 ， 它 们 只 适用 于 OldDB， 而 无 法 对 接 NewDB。 
一 个 解决 办 法 是 在 代码 中 增加 许多 if 语 句 ， 在 每 个 访问 数据 库 的 地 
方 区 分 NewDB 和 OldDB 特 殊 处 理 。 这 样 代 码 库 的 复杂 性 几乎 会 加 
倍 ， 而 Bugzilla 的 团队 只 有 少数 兼职 程序 员 ， 要 是 系统 的 复杂 性 加 
倍 ， 他 们 就 维护 不 了 了 。 

于 是 ，Bugzilla 团 队 决 是 采取 另 一 个 办 法 ， 重 新 设计 系统 ， 让 它 能 容 
易 支 持 多 种 数据 库 。 这 样 的 改动 是 个 大 工程 。 以 下 概要 描述 了 他 们 
的 步骤 。 


(1) Bugzilla 中 对 所 有 数据 库 系统 已 经 有 一 套 操作 标准 ， 但 没有 广泛 
使 用 。 所 以 检查 整个 系统 ， 每 次 修改 一 个 文件 ， 只 要 可 能 ， 就 把 它 
切换 为 标准 操作 。 

(2) 对 没有 标准 版 本 的 数据 库 操 作 ， 写 一 个 函数 ， 它 会 返回 适用 当前 
所 用 数据 库 的 正确 操作 。 为 每 个 非 标准 操作 创建 一 个 函数 ， 把 非 标准 
操作 替换 为 函数 调用 。 重 复 这 个 过 程 ， 直 到 去 掉 所 有 的 非 标准 函数 。 


(3) 项 目 中 有 许多 代码 服务 于 专属 于 OldDB 的 功能 。 停 止 使 用 这 些 
O1dDB 专 有 的 功能 ， 切 换 到 可 适用 于 所 有 数据 库 的 标准 功能 。 每 次 
只 修改 一 个 功能 ， 如 果 需 要 ， 还 可 以 分 更 细 的 步骤 。 

(4) 重新 设计 Bugziila 的 安装 程序 ， 让 它 可 以 设 定 任何 数据 库 系统 ， 
而 不 只 是 OldDB。 首 先 要 重新 设计 安装 程序 ， 把 它 变 简单 ， 然 后 此 
理 代码 ， 使 其 同时 支持 OldDB 和 NewDB。 

以 上 任何 一 步 本 身 都 是 一 个 项 目 。 它 们 被 拆 分 为 小 的 步骤 ， 所 以 每 
一 步 的 工作 都 得 到 了 良好 的 设计 。 而 且 ， 系 统 做 了 任何 改动 之 后 部 
会 进行 测试 ， 确 保 对 OldDB 的 功能 没有 变化 。 

这 样 最 后 得 到 了 一 个 完美 的 系统 吗 ? 没有 ， 只 是 得 到 了 比 之 前 更 好 
的 系统 一 一 不 但 支持 NewDB， 而 且 更 容易 维护 。 景 终 Bugzilla 能 够 
支持 4 种 不 同 的 数据 库 ， 这 全 部 是 因为 做 了 上 面 的 工作 后 ， 它 更 容 
易 支持 新 的 数据 库 了 。? 


8.5.1 把 某 个 部 分 变 简单 


上 面 说 的 都 很 不 错 ， 很 有 道理 ， 但 到 底 该 做 什么 才能 把 某 个 部 分 变 简 
单 ? 咽 ， 这 就 要 用 到 现 有 的 关于 软件 设计 的 知识 了 。 学 习 设 计 模式 和 
设计 方法 来 处 理 遗 留 代码 ， 学 习 软 件 工程 师 普遍 使 用 的 工具 ， 都 可 以 
帮 上 大 忙 ， 尤 其 有 用 的 是 黎 握 多 门 编程 语言 ， 熟 悉 多 种 不 同 的 类 库 ， 
因为 每 一 种 语言 和 类 库 都 会 用 自己 的 方式 来 思考 问题 ， 即 便 你 并 不 使 
用 这 些 语 言 和 类 库 ， 这 种 思维 方式 也 可 以 应 用 到 你 的 具体 环境 中 。 


掌握 了 这 些 知 识 ， 在 面 对 复 杂 性 问题 时 你 就 会 有 更 多 的 选择 。 软 件 设 
计 的 法 则 可 以 帮助 你 选择 不 错 的 选项 ， 在 这 之 后 ， 你 的 判断 力 和 经 验 


注 2: 在 过 去 许多 年 闻 ， 因 为 各 种 原因 ，Bugzilla 按照 这 个 套路 重新 设计 了 很 多 次 。 如 
果 你 想 知道 已 经 完成 的 重要 工作 ， 可 以 查阅 这 里 已 经 划 掉 的 项 : https://bugzilla. 
mozilla.org/showdependencytree.cgi?id=278579&hide_resolved=0。 如 果 你 想 知道 关于 
数据 库 的 改动 如 何 完 成 的 更 详细 情况 ， 请 查阅 这 里 已 经 划 掉 的 项 : https://bugzilla. 
Imozilla.org/showdependencytree.cgi?id=98304&hide_resolved=0。 如 果 你 熟悉 数据 库 
系统 ， 阅 读 各 项 的 标题 就 大 概 知道 整个 项 目 是 怎么 完成 的 了 。 


可 以 决定 针对 当前 的 具体 问题 要 做 什么 。 不 要 仅仅 因为 权威 的 肯定 就 
机 械 地 生 搬 硬 套 某 个 工具 ， 我 们 的 选择 永远 是 ， 在 当前 的 环境 下 ， 当 
前 的 代码 中 ， 做 合适 的 事情 。 


虽然 有 时 会 有 这 样 的 情况 : 你 看 到 某 一 段 代 码 ， 却 不 知道 有 什么 工具 
可 以 化 简 它 。 或 者 你 可 能 刚刚 开始 学 编程 ， 还 没有 时 间 马 上 研究 这 些 
信息 。 如 果 是 这 样 ， 你 应 该 看 着 这 个 复杂 问题 问 自己 : 要 怎么 做 ， 才 
可 以 让 事情 处 理 或 是 理解 起 来 更 容易 ? 这 就 是 在 每 个 化 解 复 杂 性 的 问 
题 背后 的 关键 点 。 应 对 之 道 在 于 找到 一 种 让 代码 更 简单 的 可 行 办 法 。 
软件 设计 的 工具 和 技巧 只 能 锦上添花 ， 帮 助 你 找到 更 好 的 答案 。 


8.5.2 不 可 解决 的 复杂 性 


简化 系统 时 ， 你 可 能 会 发 现 某 些 复 杂 性 是 无 可 避免 的 ， 可 能 所 使 用 的 
硬件 就 是 很 复杂 的 。 如 果 遇 到 这 类 不 可 解决 的 复杂 性 ， 你 要 做 的 就 是 
屏蔽 这 种 复杂 性 。 在 程序 外 面 妥善 包装 上 一 层 ， 让 其 他 程序 员 更 容易 
使 用 和 理解 。 


8.6 ”推倒 重 来 


面 对 非 常 复杂 的 系统 ， 有 些 设计 师 会 选择 推倒 重 来 。 不 过 ， 把 系统 推 
到 重 来 ， 几 乎 就 是 设计 师承 认 失 败 ， 等 于 说 :“ 我 们 设计 不 出 可 维护 
的 系统 ， 所 以 只 能 重 来 。 


有 人 认为 所 有 的 系统 最 终 都 要 重 写 ， 但 事实 不 是 这 样 的 。 系 统 在 设计 
完成 之 后 永远 不 会 被 抛弃 是 有 可 能 做 到 的 。 软 件 设计 师 所 说 的 “ 某 
天 ， 因 为 某 个 原因 ， 我 们 不 得 不 抛弃 所 有 代码 ”， 就 好 像 建 筑 师 说 的 
“这 座 摩天 大 楼 应 该 在 某 天 以 某 种 方式 倒塌 "。 如 果 摩 天 大 楼 设计 有 问 
题 ， 后 期 也 没有 很 好 地 维护 ， 那 么 它 必然 会 倒塌 。 可 要 是 从 一 开始 就 
建 得 很 好 ， 而 且 维护 得 很 好 ， 为 什么 会 倒塌 呢 ? 


既然 能 建造 出 坚固 稳定 的 摩天 大 楼 ， 也 就 能 构建 出 可 维护 的 软件 系统 。 


上 面 说 了 这 么 多 ， 不 过 ， 还 是 有 些 时 候 重 写 是 可 以 接受 的 。 但 是 ， 这 
种 情况 非常 罕见 。 如 有 果 下 面 的 条 件 全 都 满足 ， 你 才 应 该 重 写 。 


(1) 你 已 经 完成 了 准确 评估 ， 证 明 重 写 整个 系统 会 比重 新 设计 现 有 系 
统 更 有 效率 。 只 有 猜测 是 不 够 的 ， 你 需要 真正 去 做 一 些 重新 设计 现 有 
系统 的 试验 ， 然 后 对 比 结 果 。 已 有 的 复杂 系统 可 能 很 难 应 付 ， 某 些 部 
分 可 能 很 难处 理 ， 但 是 为 了 知道 修复 它 需 要 多 少时 间 ， 你 必须 动手 做 
一 些 尝试 。 

(2) 你 有 足够 的 时 间 用 来 开发 新 的 系统 。 

(3) 你 要 比 原 有 系统 的 设计 师 更 高 明 ， 或 者 ， 如 果 原 有 系统 是 你 设计 
的 ， 但 现在 你 的 设计 能 力 已 经 大 大 提升 了 。 

(4) 你 完全 打算 好 了 通过 一 系列 简单 的 步骤 设计 整个 新 系统 ， 在 每 一 
步 都 有 用 户 提供 反馈 。 

(5) 你 有 足够 的 资产， 可 兼顾 维护 原 有 系统 和 重新 设计 系统 。 绝 对 不 
要 为 了 让 程序 员 重 写 新 系统 而 停止 对 原 有 系统 的 维护 。 系 统 只 要 在 使 
用 ， 都 离 不 开 维 护 。 请 记 住 ,你 自己 的 精力 也 是 一 种 资源 ， 必 须 慎重 
分 配 一 一 如 果 两 线 作 战 ， 你 每 天 有 足够 的 时 间 分 配给 原 有 系统 和 新 系 
统 吗 ? 


如 果 上 面 的 条 件 都 满足 ， 那 么 推倒 重 来 是 可 以 接受 的 。 否 则 ， 应 该 做 
的 事情 不 是 推倒 重 来 ， 而 是 降低 现 有 系统 的 复杂 性 ， 也 就 是 通过 一 系 
列 简单 步骤 来 改进 系统 的 设计 。 


第 9 章 


测试 


我 们 无 法 保证 程序 将 来 一 直 可 以 正常 使 用 ， 只 能 保证 目前 它 可 以 正常 
运行 。 其 至 这 次 运行 是 正常 的 ， 而 下 次 就 可 能 出 现 问 题 。 可 能 周围 的 
环境 发 生 了 变化 ， 所 以 程序 无 法 运行 ， 也 可 能 你 换 了 一 台 机 器 ， 所 以 
无 法 运行 。 
不 过 ， 和 希望 还 是 有 的 一 一 我 们 并 不 会 备 受 程序 功能 不 确定 的 无 穷 煎熬 ， 
测试 法 则 (Law of Testing) 告诉 我 们 : 

你 对 软件 行为 的 了 解 程度 ， 等 于 你 真正 测试 它 的 程度 。 
软件 最 后 一 次 测试 的 时 间距 离 现 在 越 近 ， 它 可 以 继续 正常 运行 的 可 能 
性 就 越 大 。 软 件 在 越 多 的 环境 里 测试 过 ， 你 就 越 确 定 它 可 以 运行 在 这 
些 环境 中 。 上 面 所 说 的 测试 的 “程度 ”， 包 括 软 件 有 和 多少 个 方面 你 曾 
经 测试 过 ， 上 一 次 测试 是 多 久 以 前 ， 在 多 少 不 同 的 环境 下 进行 过 测 
试 。 总 的 来 说 ， 你 可 以 这 么 理解 : 


除非 亲自 测试 过 ， 否 则 你 不 知道 软件 是 否 能 正常 运行 。 
仅仅 “能 正常 运行 "， 其 实 是 非常 模糊 的 ， 所 谓 的 “能 正常 运行 ”是 
指 什么 呢 ? 你 在 测试 时 真正 知道 的 是 ， 软 件 的 行为 是 否 符合 预期 ， 
以 ， 你 必须 清楚 地 知道 预期 的 行为 。 这 个 要 求 看 来 有 点 傻 ， 而 且 是 理 
所 当然 的 ， 但 是 测试 的 关键 就 在 于 此 。 针 对 每 项 测试 ， 你 必须 问 一 个 
非常 具体 的 问题 ， 得 到 一 个 非常 具体 的 答案 。 问 题 可 能 是 :“ 程 序 局 
动 之 后 ， 用 户 会 首先 看 到 这 个 按钮 ， 那 么 程序 第 一 次 运行 的 时 候 ， 用 
户 如 果 按 下 这 个 按钮 ， 会 发 生 什 么 ? ”然后 你 会 得 到 具体 的 答案 ， 比 
如 :“ 程 序 会 弹出 一 个 窗口 ， 显 示 “Hello, World 。 
这 样 ， 就 有 了 一 个 问题 ， 而 且 知 道 了 答案 。 如 果 还 有 其 他 的 答案 ， 那 
么 软件 就 是 “不 能 正常 运行 ”的 。 
有 些 行为 非常 难 测 试 ， 你 只 能 问 :“ 如 果 用 户 这 么 做 ,程序 会 崩 江 
吗 ? ”期 望 回 答 是 “不 会 ”>。 但 是 对 设计 良好 的 软件 ， 在 大 多 数 情况 
下 ， 测 试 之 后 你 会 得 到 具体 得 多 的 信息 。 


对 
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你 还 必须 保证 测试 是 准确 的 。 如 果 测 试 显示 程序 的 行为 完 
心 全 符合 预期 ， 事实 却 并 非 如 此 ， 或 者 测试 显示 程序 崩溃 了 ， 
其 实 它 跑 得 好 好 的 ， 那 么 这 些 测 试 都 是 不 准确 的 。 


最 后 ， 你 必须 观察 测试 的 结果 ， 确 保 它 们 是 有 效 的 。 如 有 果 测 试 失败 
了 ， 必 须 有 办 法 让 你 知道 这 个 情况 ， 以 及 失败 的 具体 原因 。 


测试 可 能 因为 太 简 单 而 被 忽视 。 我 们 写 完 代码 然后 保存 就 完了 ， 却 忘 
记 了 看 它 是 否 能 正常 运行 。 可 是 ， 无 论 程序 员 多 么 聪明 ， 也 无 论 有 多 
少 理论 数据 来 证 明 你 的 代码 是 正确 的 ， 在 没有 切实 测试 过 之 前 ， 你 都 
不 知道 它 能 不 能 正常 工作 。 


只 要 你 修改 了 软件 的 某 个 部 分 ， 这 部 分 是 否 能 正常 工作 就 成 了 未 知 
数 ， 就 必须 重新 测试 。 而 且 ， 这 部 分 很 可 能 关联 到 其 他 许多 方面 ， 所 
以 你 不 知道 关联 的 部 分 是 否 会 受 影响 。 如 果 是 大 刀 阔 低地 改 ， 你 可 能 
就 需要 重新 测试 整个 程序 。 


显然 ， 你 不 会 希望 每 次 进行 了 一 点 小 修改 之 后 ， 还 要 手工 测试 整个 程 
序 。 所 以 如 今 的 程序 员 在 落实 测试 法 则 时 ， 会 编写 许多 自动 化 测试 来 
测试 所 写 的 每 一 段 代 码 。 这 样 做 的 好 处 在 于 ， 有 任何 改动 都 只 需要 重 
新 运行 这 些 测 试 即 可 ， 程 序 会 测试 系统 中 的 方方面面 ， 确 保修 改 之 后 
所 有 部 分 仍然 保持 正常 。 


网 上 有 许多 资料 讲解 如 何 编写 自动 化 测试 以 及 测试 的 一 般 原理 ， 也 出 
版 过 很 多 相关 书籍 。 测 试 领域 的 资料 丰富 详尽 ， 值 得 学 习 。 测 试 法 则 
只 负责 解释 为 什么 需要 测试 ， 什 么 时 候 需 要 测试 ， 以 及 测试 真正 能 提 
供 什么 信息 。 


附录 人 


软件 设计 的 规则 


本 附录 总 结 了 书 中 讨论 的 所 有 可 行 的 规则 。 


(1) 软件 的 目的 是 帮助 他 人 。 
(2) 软件 设计 的 方程 式 是 : 


p= WwW+V 
Ei En 
其 中 : 
D 表示 变化 的 合意 程度 可行 性 ); 
人 表示 当前 价值 ， 
表示 未 来 价值 ， 
E; 表示 开发 成 本 ， 
E, 表示 维护 成 本 。 
这 是 软件 设计 的 主要 法 则 。 随 时 间 的 推移 ， 这 个 方程 式 简化 为 : 
ye 
En 


也 就 是 说 ， 相 比 降低 实现 成 本 ,降低 维护 成 本 更 重要 。 

(3) 变化 定律 : 程序 存在 的 时 间 越久 ， 它 的 某 个 部 分 需要 变化 的 可 能 
性 越 大 。 

(4) 缺陷 定律 : 在 程序 中 新 增 缺 陷 的 可 能 性 与 代码 修改 量 成 正比 。 

(5) 简洁 定律 : 软件 任何 一 部 分 的 维护 难度 ， 反 比 于 该 部 分 的 简洁 程度 。 
(6) 测试 定律 : 你 对 软件 行为 的 了 解 程度 ， 等 于 你 真正 测试 它 的 程度 。 
就 是 这 么 多 。 本 书 中 讨论 了 很 多 的 事实 和 想法 ， 但 这 6 条 是 软件 设计 
的 法 则 。 请 注意 ， 甚 中 最 重要 的 是 要 牢记 软件 的 目的 、 软 件 设计 方程 
式 的 简化 形式 以 及 简洁 定律 。 

如 果 你 希望 把 最 重要 的 事实 综合 成 软件 设计 时 要 记得 的 两 句 话 ， 就 是 : 


。 相 比 降低 开发 成 本 ， 降 低 维 护 成 本 更 加 重要 。 

。 维护 成 本 正比 于 系统 的 复杂 程度 。 

有 了 这 两 条 ， 以 及 对 软件 目的 的 了 解 ， 再 加 上 你 知道 整个 系统 的 复杂 
性 产 自 各 部 分 的 复杂 性 ， 你 就 有 相当 的 把 握 去 重新 认识 软件 设计 这 整 
门 科 学 。 
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附录 B 


事实 、 规 则 、 条 例 、 定 义 


本 附录 列 出 了 本 书 所 涵盖 的 各 条 重要 的 事实 、 规 则 、 和 条例 、 定 义 。 


。 事实 : 好 程序 员 和 差 程序 员 的 差别 就 在 于 理解 能 力 。 差 劲 的 程序 员 
不 理解 自己 做 的 事情 ， 优 秀 的 程序 员 则 相反 。 
。 条 例 :“ 好 程序 员 ” 应 当 竭 尽 全 力 ， 把 程序 写 得 让 其 他 程序 员 容 易 
理解 。 
。 定义 : 程序 就 是 
(1) 给 计算 机 的 一 系列 指令 ，; 
(2) 计算 机 依据 指令 进行 的 操作 ， 
。 定义 : 软件 系统 中 任何 与 架构 有 关 的 技术 决策 ， 以 及 在 开发 系统 中 
所 做 的 技术 决策 ， 都 可 以 归 到 “软件 设计 ”的 范畴 里 。 
。 事实 : 每 个 写 代码 的 人 都 是 设计 师 。 
。 事实 : 设计 与 民主 无 关 ， 它 应 当 由 个 人 完成 。 
。 事实 : 软件 设计 是 有 章 (规则 ) 可 循 的 ， 它 们 可 以 被 认识 ， 可 以 被 
理解 。 规 则 是 恒久 不 变 的 ， 是 基本 的 事实 ， 而且 确 实 可 行 。 
。 规则 : 软件 的 目的 就 是 帮助 其 他 人 。 
。 事实 : 软件 设计 的 目的 如 下 。 
(1) 确保 软件 能 提供 尽 可 能 多 的 帮助 ，; 
(2) 确保 软件 能 持续 提供 尽 可 能 多 的 帮助 ，; 
(3) 设计 程序 员 能 尽 可 能 简单 地 开发 和 维护 的 软件 系统 ， 这 样 的 系统 
才能 为 用 户 提 供 尽 可 能 多 的 帮助 ， 而 且 能 持续 提供 尽 可 能 多 的 帮助 。 
。 法 则 : 软件 设计 的 方程 式 
万 = 


Wh+ We 
Bit En 


这 是 软件 设计 的 主要 规则 ， 也 可 以 这 么 表达 : 

改变 的 合意 程度 (可 行 性 )， 正 比 于 软件 当前 价值 与 未 来 价值 之 和 ， 
反比 于 实现 成 本 和 维护 成 本 之 和 。 

随 着 时 间 的 推移 ， 这 个 方程 式 会 简化 为 : 


Se 
En 


这 说 明 ， 降 低 维护 成 本 比 降低 开发 成 本 更 重要 。 
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。 条 例 : 要 做 多 少 设 计 ， 应 当 正 比 于 未 来 软件 能 够 持续 为 人 们 提供 帮 
助 的 时 间 的 长 度 。 

。 条 例 : 未 来 的 某 些 事 情 ， 是 我 们 所 不 知道 的 。 

。 事实 : 程序 员 犯 的 最 常见 也 是 最 严重 的 错误 ， 就 是 在 其 实 不 知道 未 
来 的 时 候 去 预测 未 来 。 

。 条 例 : 最 安全 的 情况 是 ， 完 全 不 尝试 预测 未 来 ， 所 有 的 设计 决策 都 
应 当 根据 当前 确切 知道 的 信息 来 做 。 

。 条 例 : 变化 定律 : 程序 存在 的 时 间 越 入 ， 它 的 某 个 部 分 需要 变化 的 
可 能 性 越 大 。 

。 事实 : 在 落实 变化 法 则 时 ， 软 件 设计 师 容易 犯 的 三 个 错误 (也 就 是 
本 书 中 的 “三 大 缺陷 ”) 是 : 
(1) 编写 不 必要 的 代码 
(2) 代码 难以 修改 
(3) 过 分 追求 通用 

。 条 例 : 直到 真正 要 用 了 才 编 写 代 码 ， 清 理 掉 用 不 到 的 代码 。 

。 条 例 : 代码 的 设计 基础 ， 应 当 是 目前 所 知 的 信息 ， 而 不 是 你 认为 未 
来 要 发 生 的 情况 。 

事实 : 如 果 设 计 让 事情 更 复杂 ， 而 不 是 更 简单 ， 就 犯 了 过 度 工程 的 
错误 。 

。 条 例 : 在 考虑 通用 时 ， 只 需要 考虑 当前 的 通用 需求 。 

。 条 例 : 采用 渐进 式 开 发 和 设计 ， 可 以 避免 三 大 缺陷 。 

。 条 例 : 缺陷 概率 法 则 : 在 程序 新 增 缺 陷 的 可 能 性 与 代码 修改 量 成 正比 。 

。 条 例 : 最 好 的 设计 ， 就 是 能 适应 外 界 尽 可 能 多 的 变化 ， 而 软件 自身 
的 变化 要 尽 可 能 少 。 

。 条 例 : 永远 不 要 “修正 ”任何 东西 ， 除 非 它 真 的 有 问题 ， 而 且 有 证 
据 表明 问题 确实 存在 。 

。 条 例 : 理想 情况 下 ， 任 何 系统 里 的 任何 信息 ， 都 应 当 只 存在 一 次 。 

。 规则 : 简洁 定律 : 软件 任何 一 部 分 的 维护 难度 ， 反 比 于 该 部 分 的 简 
洁 程 度 。 

。 事实 : 简洁 是 相对 的 。 

。 条 例 : 如 果 你 真 的 希望 成 功 ， 最 好 是 把 产品 简化 到 傻子 也 能 懂 。 
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条 例 : 要 保持 一 致 。 

条 例 : 代码 可 读 性 主要 取决 于 字母 和 符号 之 间 的 空白 排 布 。 

条 例 : 名 字 应 当 足 够 长 ， 能 够 完整 表达 其 意义 或 描述 其 功能 ， 但 不 
能 太 长 ， 以 免 影 响 阅 读 。 

条 例 : 代码 应 当 解 释 程序 为 什么 这 么 做 ， 而 不 是 它 在 做 什么 。 

条 例 : 简洁 离 不 开设 计 。 

条 例 : 你 可 以 这 样 增加 复杂 性 : 

a 扩展 软件 的 用 途 ，; 

新 增 程序 员 ， 

做 无 谓 的 改变 ， 

困 于 糟糕 的 技术 ， 

理解 错误 ， 

粳 糕 的 设计 或 者 不 做 设计 ，; 

重新 发 明 轮 子 ， 

背离 软件 原来 的 用 途 ，; 

条 例 : 可 以 通过 考察 生存 潜力 、 互 通 性 、 对 品质 的 重视 ， 判 断 某 种 
技术 是 否 “ 精 糕 ”。 

条 例 : 通常 ， 如 果 某 件 事情 变 得 非常 复杂 ， 也 就 意味 着 深 藏 在 表面 
的 复杂 之 下 ， 设 计 出 了 问题 。 

条 例 : 在 复杂 性 面前 ， 问 问 自己 “真正 要 解决 的 问题 是 什么 ”。 

条 例 : 大 多 数 麻烦 的 设计 问题 ， 都 可 以 用 在 纸 上 画 图 或 写 出 来 的 办 
法 找到 答案 。 

条 例 : 要 应 付 系统 中 的 复杂 性 ， 可 以 将 系统 分 解 成 独立 的 小 部 分 ， 
逐步 重新 设计 。 

事实 : 所 有 可 行 的 简化 ， 其 核心 问题 都 是 : 怎么 做 ， 才 可 以 让 事情 
处 理 或 是 理解 起 来 更 容易 。 

条 例 : 如 果 遇 到 不 可 解决 的 复杂 性 ， 在 程序 外 面 妥善 包装 上 一 
让 其 他 程序 员 更 容易 使 用 和 理解 。 

条 例 : 推倒 重 来 只 有 在 一 些 非常 有 限 的 情况 下 才 是 可 以 接受 的 。 
规则 :测试 定律 : 你 对 软件 行为 的 了 解 程度 ， 等 于 你 真正 测试 它 的 
程度 。 

条 例 : 除非 亲自 测试 过 ， 否 则 你 不 知道 软件 是 否 能 正常 运行 。 


汀 


? 
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| 
优秀 的 软件 设计 简单 明了 。 不 过 很 遗憾 ， 如 今 的 计算 机 程序 基本 上 

都 很 复杂 ， 孢 怕 无 人 能 够 确切 知道 所 有 代码 都 是 怎么 运转 的 。 这 本 

简明 教程 守 在 帮助 读者 利用 科学 规则 黎 握 优秀 设计 的 基础 知识 ， 书 

中 给 出 的 法 则 适用 于 所 有 编程 语言 和 软件 项 目 ， 并 且 永 远 有 效 。 

不 论 是 刚 入 门 的 程序 员 、 资 深 软件 工程 师 还 是 没有 技术 背景 的 管 

理 人 员 ， 读 过 本 书 之 后 ， 都 将 能 够 理解 如 何 创建 靠 谱 的 软件 项 目 计 

划 、 确 定 更 好 的 系统 模型 和 架构 。 


为 什么 软件 设计 成 了 一 门 缺失 的 科学 

软件 和 优秀 软件 设计 的 终极 目标 

确定 现在 以 及 将 来 软件 设计 的 价值 所 在 

用 真实 案例 证 明 系统 如 何 随时 间 变 化 而 变化 

好 的 设计 能 适应 外 界 尽 可 能 多 的 变化 ， 而 软件 自身 的 变化 尽 可 能 少 
代码 越 简洁 ， 未 来 做 改动 的 难度 就 越 低 

测试 越 准 确 ， 软 件 性 能 就 越 有 把 握 
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考 书 ， 以 免费 或 收费 的 形式 提供 给 读者 。 ( 收 ” 交 勘 误 还 能 够 获 赠 社区 银子 。 
费 形式 须 经 过 图 灵 社 区 立项 评审 。) 这 极 大 地 
降低 了 出 版 的 门槛 。 只 要 你 有 写作 的 意愿 ， 图 。 你 可 以 积极 参与 社区 经 常 开展 的 访谈 、 审 


Sr 
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x ” 读 、 评 选 等 多 种 活动 ， 启 取 积分 和 外 
灵 社 区 就 能 帮助 你 实现 这 个 梦想 。 成 熟 的 书 。 读 、 评 选 等 多 种 活动 ， 启 取 积分 和 银子 ， 积 


LE 


稿 ， 有 机 会 入 选 出 版 计划 ， 同 时 出 版 纸 质 书 。 。 累 个 人 声望 。 


图 灵 社 区 引进 出 版 的 外 文 图 书 ， 都 将 在 立项 后 
马上 在 社区 公布 。 如 果 你 有 意 翻 译 哪 本 图 书 ， 
欢迎 你 来 社区 申请 。 只 要 你 通过 试 译 的 考验 ， 
即 可 签约 成 为 图 灵 的 译 者 。 当 然 ， 要 想 成 功 地 
完成 一 本 书 的 翻译 工作 ， 是 需要 有 坚强 的 妆 力 
的 。 


